title | description | author | ms.author | ms.date | ms.topic | ms.service | services |
---|---|---|---|---|---|---|---|
Use Azure Maps Drawing Error Visualizer |
In this article, you'll learn about how to visualize warnings and errors returned by the Creator Conversion API. |
stevemunk |
v-munksteve |
05/26/2021 |
conceptual |
azure-maps |
azure-maps |
The Drawing Error Visualizer is a stand-alone web application that displays Drawing package warnings and errors detected during the conversion process. The Error Visualizer web application consists of a static page that you can use without connecting to the internet. You can use the Error Visualizer to fix errors and warnings in accordance with Drawing package requirements. The Azure Maps Conversion API returns a response with a link to the Error Visualizer only when an error is detected.
Before you can download the Drawing Error Visualizer, you'll need to:
- Create an Azure Maps account
- Obtain a primary subscription key, also known as the primary key or the subscription key.
- Create a Creator resource
This tutorial uses the Postman application, but you may choose a different API development environment.
-
Upload your Drawing package to the Azure Maps Creator service to obtain a
udid
for the uploaded package. For steps on how to upload a package, see Upload a drawing package. -
Now that the Drawing package is uploaded, we'll use
udid
for the uploaded package to convert the package into map data. For steps on how to convert a package, see Convert a drawing package.[!NOTE] If your conversion process succeeds, you will not receive a link to the Error Visualizer tool.
-
Under the response Headers tab in the Postman application, look for the
diagnosticPackageLocation
property, returned by the Conversion API. The response should appear like the following JSON:{ "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504", "created": "2020-04-22T19:39:54.9518496+00:00", "status": "Failed", "properties": { "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=2.0" } }
-
Download the Drawing Package Error Visualizer by making a
HTTP-GET
request on thediagnosticPackageLocation
URL.
Inside the downloaded zipped package from the diagnosticPackageLocation
link, you'll find two files.
- VisualizationTool.zip: Contains the source code, media, and web page for the Drawing Error Visualizer.
- ConversionWarningsAndErrors.json: Contains a formatted list of warnings, errors, and other details that are used by the Drawing Error Visualizer.
Unzip the VisualizationTool.zip folder. It contains the following items:
- assets folder: contains images and media files
- static folder: source code
- index.html file: the web application.
Open the index.html file using any of the browsers below, with the respective version number. You may use a different version, if the version offers equally compatible behavior as the listed version.
- Microsoft Edge 80
- Safari 13
- Chrome 80
- Firefox 74
After launching the Drawing Error Visualizer tool, you'll be presented with the upload page. The upload page contains a drag and drop box. The drag & drop box also functions as button that launches a File Explorer dialog.
:::image type="content" source="./media/drawing-errors-visualizer/start-page.png" alt-text="Drawing Error Visualizer App - Start Page":::
The ConversionWarningsAndErrors.json file has been placed at the root of the downloaded directory. To load the ConversionWarningsAndErrors.json, drag & drop the file onto the box. Or, click on the box, find the file in the File Explorer dialogue
, and upload the file.
:::image type="content" source="./media/drawing-errors-visualizer/loading-data.gif" alt-text="Drawing Error Visualizer App - Drag and drop to load data":::
Once the ConversionWarningsAndErrors.json file loads, you'll see a list of your Drawing package errors and warnings. Each error or warning is specified by the layer, level, and a detailed message. To view detailed information about an error or warning, click on the Details link. An intractable section will then appear below the list. You may now navigate to each error to learn more details on how to resolve the error.
:::image type="content" source="./media/drawing-errors-visualizer/errors.png" alt-text="Drawing Error Visualizer App - Errors and Warnings":::
Once your Drawing package meets the requirements, you can use the Azure Maps Dataset service to convert the Drawing package to a dataset. Then, you can use the Indoor Maps web module to develop your application. Learn more by reading the following articles:
[!div class="nextstepaction"] Drawing Conversion error codes
[!div class="nextstepaction"] Drawing Package Guide
[!div class="nextstepaction"] Creator for indoor maps
[!div class="nextstepaction"] Use the Indoor Maps module
[!div class="nextstepaction"] Implement indoor map dynamic styling