Skip to content

Commit d0467f9

Browse files
authored
Merge pull request #106294 from stevemunk/creator-fix
Correction to next steps section in how-to-creator-wfs and updated links in tutorial
2 parents e2e9859 + 2c220d5 commit d0467f9

File tree

2 files changed

+42
-20
lines changed

2 files changed

+42
-20
lines changed

articles/azure-maps/how-to-creator-wfs.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,12 +108,14 @@ After the response returns, copy the feature `id` for one of the `unit` features
108108
}
109109
```
110110

111+
## Next steps
112+
111113
> [!div class="nextstepaction"]
112114
> [How to create a feature stateset]
113115
114116
[datasets]: /rest/api/maps/v2/dataset
115117
[WFS API]: /rest/api/maps/v2/wfs
116-
[Web Feature Service (WFS)]: /rest/api/maps/v2/wfs
118+
[Web Feature Service (WFS)]: /rest/api/maps/v2/wfs
117119
[Tutorial: Use Creator to create indoor maps]: tutorial-creator-indoor-maps.md
118120
[Check dataset creation status]: tutorial-creator-indoor-maps.md#check-the-dataset-creation-status
119121
[Access to Creator Services]: how-to-manage-creator.md#access-to-creator-services

articles/azure-maps/tutorial-creator-indoor-maps.md

Lines changed: 39 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -23,27 +23,27 @@ This tutorial describes how to create indoor maps for use in Microsoft Azure Map
2323
> * Get the default map configuration ID from your tileset.
2424
2525
> [!TIP]
26-
> You can also create a dataset from a GeoJSON package. For more information, see [Create a dataset using a GeoJson package (Preview)](how-to-dataset-geojson.md).
26+
> You can also create a dataset from a GeoJSON package. For more information, see [Create a dataset using a GeoJson package (Preview)].
2727
2828
## Prerequisites
2929

30-
1. [Make an Azure Maps account](quick-demo-map-app.md#create-an-azure-maps-account).
31-
2. [Obtain a primary subscription key](quick-demo-map-app.md#get-the-primary-key-for-your-account), also known as the primary key or the subscription key.
32-
3. [Create a Creator resource](how-to-manage-creator.md).
33-
4. Download the [Sample drawing package](https://github.com/Azure-Samples/am-creator-indoor-data-examples/blob/master/Sample%20-%20Contoso%20Drawing%20Package.zip).
30+
1. An [Azure Maps account]
31+
2. A [subscription key]
32+
3. A [Creator resource]
33+
4. Download the [Sample drawing package]
3434

35-
This tutorial uses the [Postman](https://www.postman.com/) application, but you can use a different API development environment.
35+
This tutorial uses the [Postman] application, but you can use a different API development environment.
3636

3737
>[!IMPORTANT]
3838
>
39-
> * This article uses the `us.atlas.microsoft.com` geographical URL. If your Creator service wasn't created in the United States, you must use a different geographical URL. For more information, see [Access to Creator services](how-to-manage-creator.md#access-to-creator-services).
39+
> * This article uses the `us.atlas.microsoft.com` geographical URL. If your Creator service wasn't created in the United States, you must use a different geographical URL. For more information, see [Access to Creator services].
4040
> * In the URL examples in this article you will need to replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key.
4141
4242
## Upload a drawing package
4343

44-
Use the [Data Upload API](/rest/api/maps/data-v2/upload) to upload the drawing package to Azure Maps resources.
44+
Use the [Data Upload API] to upload the drawing package to Azure Maps resources.
4545

46-
The Data Upload API is a long running transaction that implements the pattern defined in [Creator Long-Running Operation API V2](creator-long-running-operation-v2.md).
46+
The Data Upload API is a long running transaction that implements the pattern defined in [Creator Long-Running Operation API V2].
4747

4848
To upload the drawing package:
4949

@@ -55,7 +55,7 @@ To upload the drawing package:
5555

5656
4. Select the **POST** HTTP method.
5757

58-
5. Enter the following URL to the [Data Upload API](/rest/api/maps/data-v2/upload) The request should look like the following URL:
58+
5. Enter the following URL to the [Data Upload API] The request should look like the following URL:
5959

6060
```http
6161
https://us.atlas.microsoft.com/mapData?api-version=2.0&dataFormat=dwgzippackage&subscription-key={Your-Azure-Maps-Subscription-key}
@@ -148,7 +148,7 @@ To retrieve content metadata:
148148
149149
## Convert a drawing package
150150
151-
Now that the drawing package is uploaded, you'll use the `udid` for the uploaded package to convert the package into map data. The [Conversion API](/rest/api/maps/v2/conversion) uses a long-running transaction that implements the pattern defined in the [Creator Long-Running Operation](creator-long-running-operation-v2.md) article.
151+
Now that the drawing package is uploaded, you'll use the `udid` for the uploaded package to convert the package into map data. The [Conversion API] uses a long-running transaction that implements the pattern defined in the [Creator Long-Running Operation] article.
152152
153153
To convert a drawing package:
154154
@@ -160,7 +160,7 @@ To convert a drawing package:
160160
161161
4. Select the **POST** HTTP method.
162162
163-
5. Enter the following URL to the [Conversion service](/rest/api/maps/v2/conversion/convert) (replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key and `udid` with the `udid` of the uploaded package):
163+
5. Enter the following URL to the [Conversion service] (replace `{Your-Azure-Maps-Subscription-key}` with your Azure Maps subscription key and `udid` with the `udid` of the uploaded package):
164164
165165
```http
166166
https://us.atlas.microsoft.com/conversions?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2.0&udid={udid}&inputType=DWG&outputOntology=facility-2.0
@@ -202,7 +202,7 @@ To check the status of the conversion process and retrieve the `conversionId`:
202202
203203
:::image type="content" source="./media/tutorial-creator-indoor-maps/data-conversion-id.png" alt-text="A screenshot of Postman highlighting the conversion ID value that appears in the resource location key in the responses header.":::
204204
205-
The sample drawing package should be converted without errors or warnings. However, if you receive errors or warnings from your own drawing package, the JSON response includes a link to the [Drawing error visualizer](drawing-error-visualizer.md). You can use the Drawing Error visualizer to inspect the details of errors and warnings. To receive recommendations to resolve conversion errors and warnings, see [Drawing conversion errors and warnings](drawing-conversion-error-codes.md).
205+
The sample drawing package should be converted without errors or warnings. However, if you receive errors or warnings from your own drawing package, the JSON response includes a link to the [Drawing error visualizer]. You can use the Drawing Error visualizer to inspect the details of errors and warnings. To receive recommendations to resolve conversion errors and warnings, see [Drawing conversion errors and warnings].
206206
207207
The following JSON fragment displays a sample conversion warning:
208208
@@ -233,7 +233,7 @@ The following JSON fragment displays a sample conversion warning:
233233

234234
## Create a dataset
235235

236-
A dataset is a collection of map features, such as buildings, levels, and rooms. To create a dataset, use the [Dataset Create API](/rest/api/maps/v2/dataset/create). The Dataset Create API takes the `conversionId` for the converted drawing package and returns a `datasetId` of the created dataset.
236+
A dataset is a collection of map features, such as buildings, levels, and rooms. To create a dataset, use the [Dataset Create API]. The Dataset Create API takes the `conversionId` for the converted drawing package and returns a `datasetId` of the created dataset.
237237

238238
To create a dataset:
239239

@@ -245,7 +245,7 @@ To create a dataset:
245245

246246
4. Select the **POST** HTTP method.
247247

248-
5. Enter the following URL to the [Dataset API](/rest/api/maps/v2/dataset). The request should look like the following URL (replace `{conversionId`} with the `conversionId` obtained in [Check drawing package conversion status](#check-the-drawing-package-conversion-status)):
248+
5. Enter the following URL to the [Dataset service]. The request should look like the following URL (replace `{conversionId`} with the `conversionId` obtained in [Check drawing package conversion status](#check-the-drawing-package-conversion-status)):
249249

250250
```http
251251
https://us.atlas.microsoft.com/datasets?api-version=2.0&conversionId={conversionId}&subscription-key={Your-Azure-Maps-Subscription-key}
@@ -299,7 +299,7 @@ To create a tileset:
299299
300300
4. Select the **POST** HTTP method.
301301
302-
5. Enter the following URL to the [Tileset API](/rest/api/maps/v2/tileset). The request should look like the following URL (replace `{datasetId`} with the `datasetId` obtained in the [Check the dataset creation status](#check-the-dataset-creation-status) section above:
302+
5. Enter the following URL to the [Tileset service]. The request should look like the following URL (replace `{datasetId`} with the `datasetId` obtained in the [Check the dataset creation status](#check-the-dataset-creation-status) section above:
303303
304304
```http
305305
https://us.atlas.microsoft.com/tilesets?api-version=2022-09-01-preview&datasetID={datasetId}&subscription-key={Your-Azure-Maps-Primary-Subscription-key}
@@ -339,7 +339,7 @@ To check the status of the tileset creation process and retrieve the `tilesetId`
339339
340340
## The map configuration (preview)
341341
342-
Once your tileset creation completes, you can get the `mapConfigurationId` using the [tileset get](/rest/api/maps/v20220901preview/tileset/get) HTTP request:
342+
Once your tileset creation completes, you can get the `mapConfigurationId` using the [tileset get] HTTP request:
343343
344344
1. In the Postman app, select **New**.
345345
@@ -349,7 +349,7 @@ Once your tileset creation completes, you can get the `mapConfigurationId` using
349349
350350
4. Select the **GET** HTTP method.
351351
352-
5. Enter the following URL to the [Tileset API](/rest/api/maps/v20220901preview/tileset), passing in the tileset ID you obtained in the previous step.
352+
5. Enter the following URL to the [Tileset service], passing in the tileset ID you obtained in the previous step.
353353
354354
```http
355355
https://us.atlas.microsoft.com/tilesets/{tilesetId}?api-version=2022-09-01-preview&subscription-key={Your-Azure-Maps-Subscription-key}
@@ -363,9 +363,29 @@ Once your tileset creation completes, you can get the `mapConfigurationId` using
363363
"defaultMapConfigurationId": "5906cd57-2dba-389b-3313-ce6b549d4396"
364364
```
365365
366-
For more information, see [Map configuration](creator-indoor-maps.md#map-configuration) in the indoor maps concepts article.
366+
For more information, see [Map configuration] in the indoor maps concepts article.
367367
368368
## Next steps
369369
370370
> [!div class="nextstepaction"]
371371
> [Use the Azure Maps Indoor Maps module with custom styles](how-to-use-indoor-module.md)
372+
373+
[Azure Maps account]: quick-demo-map-app.md#create-an-azure-maps-account
374+
[subscription key]: quick-demo-map-app.md#get-the-primary-key-for-your-account
375+
[Creator resource]: how-to-manage-creator.md
376+
[Sample drawing package]: https://github.com/Azure-Samples/am-creator-indoor-data-examples/blob/master/Sample%20-%20Contoso%20Drawing%20Package.zip
377+
[Postman]: https://www.postman.com
378+
[Access to Creator services]: how-to-manage-creator.md#access-to-creator-services
379+
[Create a dataset using a GeoJson package (Preview)]: how-to-dataset-geojson.md
380+
[Data Upload API]: /rest/api/maps/data-v2/upload
381+
[Creator Long-Running Operation API V2]: creator-long-running-operation-v2.md
382+
[Conversion API]: /rest/api/maps/v2/conversion
383+
[Conversion service]: /rest/api/maps/v2/conversion/convert
384+
[Creator Long-Running Operation]: creator-long-running-operation-v2.md
385+
[Drawing error visualizer]: drawing-error-visualizer.md
386+
[Drawing conversion errors and warnings]: drawing-conversion-error-codes.md
387+
[Dataset Create API]: /rest/api/maps/v2/dataset/create
388+
[Dataset service]: /rest/api/maps/v2/dataset
389+
[Tileset service]: /rest/api/maps/v20220901preview/tileset
390+
[tileset get]: /rest/api/maps/v20220901preview/tileset/get
391+
[Map configuration]: creator-indoor-maps.md#map-configuration

0 commit comments

Comments
 (0)