Skip to content

Commit 6dd5d39

Browse files
author
anastasia-ms
committed
PR Review fixes
1 parent b2bee7a commit 6dd5d39

39 files changed

+83
-81
lines changed

articles/azure-maps/creator-for-indoor-maps.md renamed to articles/azure-maps/creator-indoor-maps.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Creator for indoor maps| Microsoft Azure Maps
2+
title: Work with indoor maps in Azure Maps Creator
33
description: This article introduces concepts that apply to Azure Maps Creator services.
44
author: anastasia-ms
55
ms.author: v-stharr
6-
ms.date: 05/07/2020
6+
ms.date: 05/18/2020
77
ms.topic: conceptual
88
ms.service: azure-maps
99
services: azure-maps
@@ -17,7 +17,7 @@ This article introduces concepts and tools that apply to Azure Maps Creator. We
1717

1818
You can use Creator to develop applications with map features based on indoor map data. This article describes the process of uploading, converting, creating, and using your map data. The entire workflow is illustrated in the diagram below.
1919

20-
![Creator map data workflow](./media/creator-for-indoor-maps/workflow.png)
20+
![Creator map data workflow](./media/creator-indoor-maps/workflow.png)
2121

2222
## Create Azure Maps Creator
2323

@@ -27,17 +27,17 @@ To use Creator services, Azure Maps Creator must be created in an Azure Maps acc
2727

2828
Creator collects indoor map data by converting an uploaded Drawing package. The Drawing package represents a constructed or remodeled facility. For information on Drawing package requirements, see [Drawing package requirements](drawing-requirements.md).
2929

30-
Use the [Azure Maps Data Upload API](https://docs.microsoft.com/rest/api/maps/data/uploadpreview) to upload a Drawing package. Upon a successful upload, the Data Upload API will return a *user data identifier (`udid`). The `udid` will be used in the next step to convert the uploaded package into indoor map data.
30+
Use the [Azure Maps Data Upload API](https://docs.microsoft.com/rest/api/maps/data/uploadpreview) to upload a Drawing package. Upon a successful upload, the Data Upload API will return a user data identifier (`udid`). The `udid` will be used in the next step to convert the uploaded package into indoor map data.
3131

3232
## Convert a Drawing package
3333

3434
The [Azure Maps Conversion service](https://docs.microsoft.com/rest/api/maps/data/conversion) converts an uploaded Drawing package into indoor map data. The Conversion service also validates the package. Validation issues are classified into two types: errors and warnings. If any errors are detected, the conversion process fails. Should warnings be detected, the conversion will succeed. However, it’s recommended that you review and resolve all warnings. A warning means that part of the conversion was ignored or automatically fixed. Failing to resolve the warnings could result in errors in latter processes. For more information, see [Drawing package warnings and errors](drawing-conversion-error-codes.md).
3535

36-
When an error occurs, the Conversion service provides a link to the [Azure Maps Drawing Error Visualizer](azure-maps-drawing-errors-visualizer.md) stand-alone web application. You can use the Drawing Error Visualizer to inspect [Drawing package warnings and errors](drawing-conversion-error-codes.md) that occurred during the conversion process. Once you have fixed the errors, you can then attempt to upload and convert the package.
36+
When an error occurs, the Conversion service provides a link to the [Azure Maps Drawing Error Visualizer](drawing-error-visualizer.md) stand-alone web application. You can use the Drawing Error Visualizer to inspect [Drawing package warnings and errors](drawing-conversion-error-codes.md) that occurred during the conversion process. Once you have fixed the errors, you can then attempt to upload and convert the package.
3737

3838
## Create indoor map data
3939

40-
Azure Maps Creator provides four services:
40+
Azure Maps Creator provides three services:
4141

4242
* [Dataset service](https://docs.microsoft.com/rest/api/maps/dataset/createpreview).
4343
Use the Dataset service to create a dataset from a converted Drawing package data.

articles/azure-maps/creator-long-running-operation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Azure Maps Long-Running Operation API | Microsoft Azure Maps
2+
title: Azure Maps Long-Running Operation API
33
description: Learn about long-running asynchronous background processing in Azure Maps
44
author: anastasia-ms
55
ms.author: v-stharr
6-
ms.date: 05/01/2020
6+
ms.date: 05/18/2020
77
ms.topic: conceptual
88
ms.service: azure-maps
99
services: azure-maps

articles/azure-maps/drawing-conversion-error-codes.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Drawing Conversion Error and Warning in Azure Maps | Microsoft Docs
2+
title: Azure Maps Drawing Conversion errors and warnings
33
description: Learn about the Conversion errors and warnings you may meet while you're using the Azure Maps Conversion service. Read the recommendations on how to resolve the errors and the warnings, with some examples.
44
author: anastasia-ms
55
ms.author: v-stharr
6-
ms.date: 05/04/2020
6+
ms.date: 05/18/2020
77
ms.topic: conceptual
88
ms.service: azure-maps
99
services: azure-maps
@@ -30,13 +30,13 @@ The Conversion service is unable to create a map feature from an invalid entity
3030

3131
* The two images below show examples of self-intersecting polygons.
3232

33-
![Example of a self-intersecting polygon](./media/drawing-conversion-error-codes/geometryWarning1.png)
33+
![Example of a self-intersecting polygon](./media/drawing-conversion-error-codes/geometry-warning-1.png)
3434

35-
![Example of a self-intersecting polygon](./media/drawing-conversion-error-codes/geometryWarning2.png)
35+
![Example of a self-intersecting polygon](./media/drawing-conversion-error-codes/geometry-warning-2.png)
3636

3737
* Below is an image that shows a non-closed PolyLine. Assume that the layer only supports closed geometry.
3838

39-
![Example of a non-closed PolyLine](./media/drawing-conversion-error-codes/geometryWarning3.png)
39+
![Example of a non-closed PolyLine](./media/drawing-conversion-error-codes/geometry-warning-3.png)
4040

4141
#### *How to fix geometryWarning*
4242

@@ -52,7 +52,7 @@ An **unexpectedGeometryInLayer** warning occurs when the drawing contains geomet
5252

5353
The image below shows a non-closed PolyLine. Assume that the layer only supports closed geometry.
5454

55-
![Example of a non-closed PolyLine](./media/drawing-conversion-error-codes/geometryWarning3.png)
55+
![Example of a non-closed PolyLine](./media/drawing-conversion-error-codes/geometry-warning-3.png)
5656

5757
#### *How to fix unexpectedGeometryInLayer*
5858

@@ -68,7 +68,7 @@ The **unsupportedFeatureRepresentation** warning occurs when the drawing contain
6868

6969
The image below shows an unsupported entity type as a multi-line text object on a label layer.
7070

71-
![Example of a multi-line text object on label layer](./media/drawing-conversion-error-codes/multiLine.png)
71+
![Example of a multi-line text object on label layer](./media/drawing-conversion-error-codes/multiline.png)
7272

7373
#### *How to fix unsupportedFeatureRepresentation*
7474

@@ -84,15 +84,15 @@ The **automaticRepairPerformed** warning occurs when the Conversion service auto
8484

8585
* The following image shows how the Conversion service repaired a self-intersecting polygon into valid geometry.
8686

87-
![Example of a self-intersecting polygon repaired](./media/drawing-conversion-error-codes/automaticRepair1.png)
87+
![Example of a self-intersecting polygon repaired](./media/drawing-conversion-error-codes/automatic-repair-1.png)
8888

8989
* The image below shows how the Conversion service snapped the first and last vertex of a non-closed PolyLine to create a closed PolyLine, where the first and last vertex were less than 1 mm apart.
9090

91-
![Example of a snapped PolyLine](./media/drawing-conversion-error-codes/automaticRepair2.png)
91+
![Example of a snapped PolyLine](./media/drawing-conversion-error-codes/automatic-repair-2.png)
9292

9393
* The image below shows how, in a layer that supports only closed PolyLines, the Conversion service repaired multiple non-closed PolyLines. In order to avoid discarding the non-closed PolyLines, the service combined them into a single closed PolyLine.
9494

95-
![Example of non-closed Polylines combined into a single closed PolyLine](./media/drawing-conversion-error-codes/automaticRepair3.png)
95+
![Example of non-closed Polylines combined into a single closed PolyLine](./media/drawing-conversion-error-codes/automatic-repair-3.png)
9696

9797
#### *How to fix automaticRepairPerformed*
9898

@@ -184,11 +184,11 @@ The **wallOutsideLevel** warning occurs when the drawing contains a Wall geometr
184184

185185
* The image below shows an interior wall, in red, outside the yellow level boundary.
186186

187-
![Example of interior wall outside the level boundary](./media/drawing-conversion-error-codes/wallOutsideLevel.png)
187+
![Example of interior wall outside the level boundary](./media/drawing-conversion-error-codes/wall-outside-level.png)
188188

189189
* The following image shows an exterior wall, in red, outside the yellow level boundary.
190190

191-
![Example of exterior wall outside the level boundary](./media/drawing-conversion-error-codes/wallOutsideLevelExterior.png)
191+
![Example of exterior wall outside the level boundary](./media/drawing-conversion-error-codes/wall-outside-level-exterior.png)
192192

193193
#### *How to fix wallOutsideLevel*
194194

@@ -206,7 +206,7 @@ A **unitOutsideLevel** warning occurs when the drawing contains unit geometry ou
206206

207207
In the following image, unit geometry, in red, exceeds the bounds of the yellow level boundary.
208208

209-
![Example of unit exceeding the level boundary](./media/drawing-conversion-error-codes/unitOutsideLevel.png)
209+
![Example of unit exceeding the level boundary](./media/drawing-conversion-error-codes/unit-outside-level.png)
210210

211211
#### *How to fix unitOutsideLevel*
212212

@@ -222,7 +222,7 @@ A **partiallyOverlappingUnit** warning occurs when the drawing contains a unit g
222222

223223
In the following image, the overlapping unit is highlighted in red. `UNIT110` and `HALLWAY` are discarded.
224224

225-
![Example of overlapping units](./media/drawing-conversion-error-codes/partiallyOverlappingUnit.png)
225+
![Example of overlapping units](./media/drawing-conversion-error-codes/partially-overlapping-unit.png)
226226

227227
#### *How to fix partiallyOverlappingUnit*
228228

@@ -240,7 +240,7 @@ A **doorOutsideLevel** warning occurs when the drawing contains a door geometry
240240

241241
In the following image, the door geometry, highlighted in red, overlaps the yellow level boundary.
242242

243-
![Example of a door overlapping a level boundary](./media/drawing-conversion-error-codes/doorOutsideLevel.png)
243+
![Example of a door overlapping a level boundary](./media/drawing-conversion-error-codes/door-outside-level.png)
244244

245245
#### *How to fix doorOutsideLevel*
246246

@@ -258,7 +258,7 @@ The **zoneWarning** occurs when a zone doesn't contain a label. The Conversion s
258258

259259
The following image shows a zone that doesn't contain a label.
260260

261-
![Example of a zone doesn't contain a label](./media/drawing-conversion-error-codes/zoneWarning.png)
261+
![Example of a zone doesn't contain a label](./media/drawing-conversion-error-codes/zone-warning.png)
262262

263263
#### *How to fix zoneWarning*
264264

@@ -282,7 +282,7 @@ A **labelWarning** occurs because of one or more of the following reasons:
282282

283283
The following image shows a label that inside two zones.
284284

285-
![Example of a label inside two zones ](./media/drawing-conversion-error-codes/labelWarning.png)
285+
![Example of a label inside two zones ](./media/drawing-conversion-error-codes/label-warning.png)
286286

287287
#### *How to fix labelWarning*
288288

@@ -462,7 +462,7 @@ The **wallError** occurs when the drawing contains an error while attempting to
462462

463463
The following image displays a wall feature that doesn't overlap any units.
464464

465-
![Example of Wall feature that doesn't overlap any units](./media/drawing-conversion-error-codes/wallError.png)
465+
![Example of Wall feature that doesn't overlap any units](./media/drawing-conversion-error-codes/wall-error.png)
466466

467467
#### *How to fix wallError*
468468

@@ -485,11 +485,11 @@ The **verticalPenetrationError** occurs because of one or more of the following
485485

486486
The image below shows a vertical penetration area with no overlapping vertical penetration areas on levels above or below it.
487487

488-
![Example of a vertical penetration 1](./media/drawing-conversion-error-codes/VRT2.png)
488+
![Example of a vertical penetration 1](./media/drawing-conversion-error-codes/vrt-2.png)
489489

490490
The following image shows a vertical penetration area that overlaps more than one vertical penetration area on an adjacent level.
491491

492-
![Example of a vertical penetration 2](./media/drawing-conversion-error-codes/VRT.png)
492+
![Example of a vertical penetration 2](./media/drawing-conversion-error-codes/vrt.png)
493493

494494
#### How to fix verticalPenetrationError
495495

@@ -498,7 +498,7 @@ To fix a **verticalPenetrationError** error, read about how to use a vertical pe
498498
## Next steps
499499

500500
> [!div class="nextstepaction"]
501-
> [How to use Azure Maps Drawing error visualizer](azure-maps-drawing-errors-visualizer.md)
501+
> [How to use Azure Maps Drawing error visualizer](drawing-error-visualizer.md)
502502
503503
> [!div class="nextstepaction"]
504-
> [Creator for indoor mapping](creator-for-indoor-maps.md)
504+
> [Creator for indoor mapping](creator-indoor-maps.md)

articles/azure-maps/azure-maps-drawing-errors-visualizer.md renamed to articles/azure-maps/drawing-error-visualizer.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Use Azure Maps Drawing Error Visualizer | Microsoft Azure Maps
2+
title: Use Azure Maps Drawing Error Visualizer
33
description: In this article, you'll learn about how to visualize warnings and errors returned by the Creator Conversion API.
44
author: anastasia-ms
55
ms.author: v-stharr
6-
ms.date: 04/27/2020
6+
ms.date: 05/18/2020
77
ms.topic: conceptual
88
ms.service: azure-maps
99
services: azure-maps
@@ -73,15 +73,15 @@ Open the _index.html_ file using any of the browsers below, with the respective
7373

7474
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.
7575

76-
![Drawing Error Visualizer App - Start Page](./media/azure-maps-dwg-errors-visualizer/start-page.png)
76+
![Drawing Error Visualizer App - Start Page](./media/drawing-errors-visualizer/start-page.png)
7777

7878
The _ConversionWarningsAndErrors.json_ file has been placed at the root of the downloaded directory. To load the _ConversionWarningsAndErrors.json_ you can either drag & drop the file onto the box or click on the box, find the file in the File Explorer dialogue, and then upload the file.
7979

80-
![Drawing Error Visualizer App - Drag and drop to load data](./media/azure-maps-dwg-errors-visualizer/loading-data.gif)
80+
![Drawing Error Visualizer App - Drag and drop to load data](./media/drawing-errors-visualizer/loading-data.gif)
8181

8282
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. You may now navigate to each error to learn more details on how to resolve the error.
8383

84-
![Drawing Error Visualizer App - Errors and Warnings](./media/azure-maps-dwg-errors-visualizer/errors.png)
84+
![Drawing Error Visualizer App - Errors and Warnings](./media/drawing-errors-visualizer/errors.png)
8585

8686
## Next steps
8787

@@ -91,7 +91,7 @@ Once your [Drawing package meets the requirements](drawing-requirements.md), you
9191
> [Drawing Conversion error codes](drawing-conversion-error-codes.md)
9292

9393
> [!div class="nextstepaction"]
94-
> [Creator for indoor maps](creator-for-indoor-maps.md)
94+
> [Creator for indoor maps](creator-indoor-maps.md)
9595

9696
> [!div class="nextstepaction"]
9797
> [Use the Indoor Maps module](how-to-use-indoor-module.md)

articles/azure-maps/drawing-requirements.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Drawing package requirements in Creator | Microsoft Docs
2+
title: Drawing package requirements in Azure Maps Creator
33
description: Learn about the Drawing package requirements to convert your facility design files to map data using the Azure Maps Conversion service
44
author: anastasia-ms
55
ms.author: v-stharr
6-
ms.date: 5/01/2020
6+
ms.date: 5/18/2020
77
ms.topic: conceptual
88
ms.service: azure-maps
99
services: azure-maps
@@ -12,7 +12,7 @@ manager: philMea
1212

1313
# Drawing package requirements
1414

15-
The [Azure Maps Conversion service](https://docs.microsoft.com/rest/api/maps/data/conversion) lets you convert uploaded Drawing packages into map data. This article describes the Drawing package requirements for the Conversion API. To view a sample package, you can download the sample [Conversion Drawing package](https://github.com/Azure-Samples/am-creator-indoor-data-examples).
15+
The [Azure Maps Conversion service](https://docs.microsoft.com/rest/api/maps/data/conversion) lets you convert uploaded Drawing packages into map data. This article describes the Drawing package requirements for the Conversion API. To view a sample package, you can download the sample [Drawing package](https://github.com/Azure-Samples/am-creator-indoor-data-examples).
1616

1717
## Prerequisites
1818

@@ -262,9 +262,11 @@ The `zoneProperties` object contains a JSON array of zone properties.
262262
|zoneNameSubtitle| string/int | false |Subtitle of the zone. |
263263

264264
### Sample Drawing package manifest
265-
Below is a sample manifest file for the sample Drawing package. To download the entire package, click [sample Drawing package](https://github.com/Azure-Samples/Azure-Maps-DWG-Package-Samples).
265+
266+
Below is a sample manifest file for the sample Drawing package. To download the entire package, click [sample Drawing package](https://github.com/Azure-Samples/am-creator-indoor-data-examples).
266267

267268
#### Manifest File
269+
268270
```JSON
269271
{
270272
    "version": "1.1",
@@ -398,7 +400,7 @@ Below is a sample manifest file for the sample Drawing package. To download the
398400
Once your Drawing package meets the requirements, you may use the [Azure Maps Conversion service](https://docs.microsoft.com/rest/api/maps/data/conversion) to convert the package to a map dataset. Then, you can use the dataset to generate an indoor map using the Indoor Maps module. Learn more about using the Indoor Maps module by reading the following articles:
399401

400402
> [!div class="nextstepaction"]
401-
>[Creator for indoor maps](creator-for-indoor-maps.md)
403+
>[Creator for indoor maps](creator-indoor-maps.md)
402404
403405
> [!div class="nextstepaction"]
404406
> [Tutorial: Creating a Creator indoor map](tutorial-creator-indoor-maps.md)

0 commit comments

Comments
 (0)