Skip to content

Commit 0c5a403

Browse files
Merge pull request #216841 from stevemunk/SM-Building-GeoJson-Dataset-swagger-links
Update how-to-dataset-geojson.md added links to swagger docs
2 parents cbb9f3c + 80d9f26 commit 0c5a403

File tree

1 file changed

+4
-12
lines changed

1 file changed

+4
-12
lines changed

articles/azure-maps/how-to-dataset-geojson.md

Lines changed: 4 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: How to create a dataset using a GeoJson package
3-
description: Learn how to create a dataset using a GeoJson package embedding the module's JavaScript libraries.
3+
description: Learn how to create a dataset using a GeoJson package.
44
author: stevemunk
55
ms.author: v-munksteve
6-
ms.date: 10/31/2021
6+
ms.date: 11/01/2021
77
ms.topic: how-to
88
ms.service: azure-maps
99
services: azure-maps
@@ -66,10 +66,8 @@ https://us.atlas.microsoft.com/mapData/operations/{operationId}?api-version=2.0&
6666
1. Copy the value of the `Resource-Location` key in the response header, which is the `resource location URL`. The `resource location URL` contains the unique identifier (`udid`) of the GeoJSON package resource.
6767

6868
### Create a dataset
69-
<!--
69+
7070
A dataset is a collection of map features, such as buildings, levels, and rooms. To create a dataset from your GeoJSON, use the new [Dataset Create API][Dataset Create 2022-09-01-preview]. The Dataset Create API takes the `udid` you got in the previous section and returns the `datasetId` of the new dataset.
71-
-->
72-
A dataset is a collection of map features, such as buildings, levels, and rooms. To create a dataset from your GeoJSON, use the new create dataset API. The create dataset API takes the `udid` you got in the previous section and returns the `datasetId` of the new dataset.
7371

7472
> [!IMPORTANT]
7573
> This is different from the [previous version][Dataset Create] in that it doesn't require a `conversionId` from a converted Drawing package.
@@ -104,11 +102,7 @@ See [Next steps](#next-steps) for links to articles to help you complete your in
104102
105103
## Add data to an existing dataset
106104
107-
<!--
108105
Data can be added to an existing dataset by providing the `datasetId` parameter to the [dataset create API][Dataset Create 2022-09-01-preview] along with the unique identifier of the data you wish to add. The unique identifier can be either a `udid` or `conversionId`. This creates a new dataset consisting of the data (facilities) from both the existing dataset and the new data being imported. Once the new dataset has been created successfully, the old dataset can be deleted.
109-
-->
110-
111-
Data can be added to an existing dataset by providing the `datasetId` parameter to the create dataset API along with the unique identifier of the data you wish to add. The unique identifier can be either a `udid` or `conversionId`. This creates a new dataset consisting of the data (facilities) from both the existing dataset and the new data being imported. Once the new dataset has been created successfully, the old dataset can be deleted.
112106
113107
One thing to consider when adding to an existing dataset is how the feature IDs are created. If a dataset is created from a converted drawing package, the feature IDs are generated automatically. When a dataset is created from a GeoJSON package, feature IDs must be provided in the GeoJSON file. When appending to an existing dataset, the original dataset drives the way feature IDs are created. If the original dataset was created using a `udid`, it uses the IDs from the GeoJSON, and will continue to do so with all GeoJSON packages appended to that dataset in the future. If the dataset was created using a `conversionId`, IDs will be internally generated, and will continue to be internally generated with all GeoJSON packages appended to that dataset in the future.
114108
@@ -125,8 +119,6 @@ https://us.atlas.microsoft.com/datasets?api-version=2022-09-01-preview&conversio
125119
| conversionId | The ID returned when converting your drawing package. For more information, see [Convert a Drawing package][conversion]. |
126120
| datasetId | The dataset ID returned when creating the original dataset from a GeoJSON package). |
127121

128-
<!--For more information, see [][].-->
129-
130122
## Geojson zip package requirements
131123

132124
The GeoJSON zip package consists of one or more [RFC 7946][RFC 7946] compliant GeoJSON files, one for each feature class, all in the root directory (subdirectories aren't supported), compressed with standard Zip compression and named using the `.ZIP` extension.
@@ -186,5 +178,5 @@ Feature IDs can only contain alpha-numeric (a-z, A-Z, 0-9), hyphen (-), dot (.)
186178
[Facility Ontology]: creator-facility-ontology.md?pivots=facility-ontology-v2
187179
[RFC 7946]: https://www.rfc-editor.org/rfc/rfc7946.html
188180
[dataset-concept]: creator-indoor-maps.md#datasets
189-
<!--[Dataset Create 2022-09-01-preview]: /rest/api/maps/v20220901preview/dataset/create-->
181+
[Dataset Create 2022-09-01-preview]: /rest/api/maps/v20220901preview/dataset/create
190182
[Visual Studio]: https://visualstudio.microsoft.com/downloads/

0 commit comments

Comments
 (0)