diff --git a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/alias.json b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/alias.json
index 13630019c12b..5f6ef30ed777 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/alias.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/alias.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for managing aliases in Azure Maps."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -87,6 +94,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"SubscriptionKey": {
"name": "subscription-key",
"description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.",
@@ -133,7 +167,7 @@
"/alias": {
"post": {
"x-publish": true,
- "description": "**Alias - Create API**\n\n**Applies to:** S1 pricing tier.\n
\n\nThis API allows the caller to create an alias.
\nYou can also assign the alias during the create request as well.\n\n\n### Submit Create Request\n\nTo create your alias, you will use a `POST` request. If you would like to assign the alias during the creation, you will pass the `resourceId` query parameter.
\n\n\n### Create Alias Response\n\nThe Create API returns a HTTP `201 Created` response the id of the alias, `aliasId`, in the body.\nThe response will look something like:\n\n```json\n{\n \"aliasId\" : \"d7e5efc8-2239-4387-a286-5bb51aa804e3\"\n}\n```\n\n
",
+ "description": "**Alias - Create API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis API allows the caller to create an alias.
\nYou can also assign the alias during the create request as well.\n\n\n### Submit Create Request\n\nTo create your alias, you will use a `POST` request. If you would like to assign the alias during the creation, you will pass the `resourceId` query parameter.
\n\n\n### Create Alias Response\n\nThe Create API returns a HTTP `201 Created` response the id of the alias, `aliasId`, in the body.\nThe response will look something like:\n\n```json\n{\n \"aliasId\" : \"d7e5efc8-2239-4387-a286-5bb51aa804e3\"\n}\n```\n\n
",
"operationId": "Alias_CreatePreview",
"x-ms-examples": {
"Create an alias that does not reference any resource": {
@@ -180,7 +214,7 @@
},
"get": {
"x-publish": true,
- "description": "**Alias - List API**\n\n**Applies to:** S1 pricing tier.\n
\n\nThis API allows the caller to fetch a list of all previously successfully created aliases.\n\n\n### Submit List Request\n\nTo list all your aliases, you will issue a `GET` request with no additional parameters.
\n\n\n### List Data Response\n\nThe List API returns the complete list of all aliases in `json` format. The response contains the following details for each alias resource:\n\n > createdTimestamp - The timestamp that the alias was created.\n > aliasId - The id for the alias.\n > resourceId - The id for the resource that this alias references (could be null if the alias has not been assigned).\n > lastUpdatedTimestamp - The last time the alias was assigned to a resource.\n\n\nHere's a sample response returning 2 alias resources: \n\n
\n\n```json\n{\n \"aliases\": [\n {\n \"createdTimestamp\": \"2020-02-13T21:19:11+00:00\",\n \"aliasId\": \"a8a4b8bb-ecf4-fb27-a618-f41721552766\",\n \"resourceId\": \"e89aebb9-70a3-8fe1-32bb-1fbd0c725f14\",\n \"lastUpdatedTimestamp\": \"2020-02-13T21:19:22+00:00\"\n },\n {\n \"createdTimestamp\": \"2020-02-18T19:53:33+00:00\",\n \"aliasId\": \"1856dbfc-7a66-ee5a-bf8d-51dbfe1906f6\",\n \"resourceId\": null,\n \"lastUpdatedTimestamp\": \"2020-02-18T19:53:33+00:00\"\n }\n ]\n}\n```\n\n
",
+ "description": "**Alias - List API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis API allows the caller to fetch a list of all previously successfully created aliases.\n\n\n### Submit List Request\n\nTo list all your aliases, you will issue a `GET` request with no additional parameters.
\n\n\n### List Data Response\n\nThe List API returns the complete list of all aliases in `json` format. The response contains the following details for each alias resource:\n\n > createdTimestamp - The timestamp that the alias was created.\n > aliasId - The id for the alias.\n > resourceId - The id for the resource that this alias references (could be null if the alias has not been assigned).\n > lastUpdatedTimestamp - The last time the alias was assigned to a resource.\n\n\nHere's a sample response returning 2 alias resources: \n\n
\n\n```json\n{\n \"aliases\": [\n {\n \"createdTimestamp\": \"2020-02-13T21:19:11+00:00\",\n \"aliasId\": \"a8a4b8bb-ecf4-fb27-a618-f41721552766\",\n \"resourceId\": \"e89aebb9-70a3-8fe1-32bb-1fbd0c725f14\",\n \"lastUpdatedTimestamp\": \"2020-02-13T21:19:22+00:00\"\n },\n {\n \"createdTimestamp\": \"2020-02-18T19:53:33+00:00\",\n \"aliasId\": \"1856dbfc-7a66-ee5a-bf8d-51dbfe1906f6\",\n \"resourceId\": null,\n \"lastUpdatedTimestamp\": \"2020-02-18T19:53:33+00:00\"\n }\n ]\n}\n```\n\n
",
"operationId": "Alias_ListPreview",
"x-ms-examples": {
"List all the previously created aliases": {
@@ -223,7 +257,7 @@
"/alias/assign/{aliasId}": {
"patch": {
"x-publish": true,
- "description": "**Alias - Assign API**\n\n**Applies to:** S1 pricing tier.\n
\n\nThis API allows the caller to assign an alias to reference a resource.
\n\n\n### Submit Assign Request\n\nTo assign your alias to a resource, you will use a `PATCH` request with the `aliasId` in the path and the `resourceId` passed as a query parameter.
\n\n\n### Create Alias Response\n\nThe Assign API returns a HTTP `204 No Content` response with an empty body, if the alias was assigned successfully.
",
+ "description": "**Alias - Assign API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis API allows the caller to assign an alias to reference a resource.
\n\n\n### Submit Assign Request\n\nTo assign your alias to a resource, you will use a `PATCH` request with the `aliasId` in the path and the `resourceId` passed as a query parameter.
\n\n\n### Create Alias Response\n\nThe Assign API returns a HTTP `204 No Content` response with an empty body, if the alias was assigned successfully.
",
"operationId": "Alias_AssignPreview",
"x-ms-examples": {
"Assign an alias to a resource": {
@@ -272,7 +306,7 @@
"/alias/{aliasId}": {
"delete": {
"x-publish": true,
- "description": "**Alias - Delete API**\n\n**Applies to:** S1 pricing tier.\n
\n\nThis API allows the caller to delete a previously created alias.
\nYou can also use this API to delete old/unused aliases to create space for new content.\nThis API does not delete the references resource, only the alias referencing the resource.\n\n\n### Submit Delete Request\n\nTo delete your alias you will issue a `DELETE` request where the path will contain the `aliasId` of the alias to delete.
\n\n\n### Delete Alias Response\n\nThe Delete API returns a HTTP `204 No Content` response with an empty body, if the alias was deleted successfully.
\nA HTTP `400 Bad Request` error response will be returned if the alias with the passed-in `aliasId` is not found. ",
+ "description": "**Alias - Delete API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis API allows the caller to delete a previously created alias.
\nYou can also use this API to delete old/unused aliases to create space for new content.\nThis API does not delete the references resource, only the alias referencing the resource.\n\n\n### Submit Delete Request\n\nTo delete your alias you will issue a `DELETE` request where the path will contain the `aliasId` of the alias to delete.
\n\n\n### Delete Alias Response\n\nThe Delete API returns a HTTP `204 No Content` response with an empty body, if the alias was deleted successfully.
\nA HTTP `400 Bad Request` error response will be returned if the alias with the passed-in `aliasId` is not found. ",
"operationId": "Alias_DeletePreview",
"x-ms-examples": {
"Delete previously created alias": {
diff --git a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Assign.json b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Assign.json
index 352eacf788fc..510eadf5d277 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Assign.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Assign.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"aliasId": "[aliasId]",
diff --git a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Create.json b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Create.json
index 173db30afe23..4ceff472346f 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Create.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Create.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Delete.json b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Delete.json
index 11adb1e66418..fc920bdb905e 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Delete.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_Delete.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"aliasId": "[aliasId]"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_List.json b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_List.json
index e74d2c24197f..918b6bc1c103 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Alias/preview/1.0/examples/Alias_List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/data.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/data.json
index a604de6af9dd..329cb1ec6e98 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/data.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/data.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for uploading map data to Azure Maps."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -98,6 +105,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"ClientId": {
"name": "x-ms-client-id",
"description": "Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from Azure Maps management plane Account API. To use Azure AD security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.",
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Delete.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Delete.json
index ccf95148e20a..50c9ce448af5 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Delete.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Delete.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"udid": "25084fb7-307a-4720-8f91-7952a0b91012"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Download.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Download.json
index 1c065fe041ea..92222b3078f2 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Download.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Download.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"udid": "25084fb7-307a-4720-8f91-7952a0b91012"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/List.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/List.json
index 741fdd026baf..5123768fe957 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Update.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Update.json
index 20caaf53f5d6..fbefa37257db 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Update.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Update.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"udid": "25084fb7-307a-4720-8f91-7952a0b91012",
diff --git a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Upload.json b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Upload.json
index dd663049a9a0..1eef53581827 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Upload.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Data/preview/1.0/examples/Upload.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"dataFormat": "geojson",
diff --git a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/dataset.json b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/dataset.json
index db865b8f6569..629ca82f3036 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/dataset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/dataset.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for managing datasets from uploaded data in Azure Maps."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -105,6 +112,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"SubscriptionKey": {
"name": "subscription-key",
"description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.",
@@ -225,7 +259,7 @@
"/dataset/create": {
"post": {
"x-publish": true,
- "description": "**Dataset Create API**\n\n**Applies to:** S1 pricing tier.\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. The Dataset APIs are part of Creator. This API allows the caller to create a dataset from data that \nwas uploaded to the Azure Maps Data Service.\n\nYou can use this API in a scenario like uploading a DWG zip package for a building, converting the zip package using \nthe Azure Maps Conversion Service, creating a dataset from the converted zip package. The created dataset can be \nused to create tilesets using the Azure Maps Tileset Service and can be queried via the Azure Maps WFS Service.\n\n## Submit Create Request\n\nTo create your dataset, you will use a `POST` request where the `conversionId` query parameter is an id that represents \nthe converted DWG zip package, the `type` parameter will describe the data type to use for the dataset, the `datasetId`\nparameter will describe if the provided data should be appended to a current dataset and, optionally, the \n`description` query parameter will contain a description (if description is not provided a default description will be \ngiven).\n\nThe Create API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
+ "description": "**Dataset Create API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. The Dataset APIs are part of Creator. This API allows the caller to create a dataset from data that \nwas uploaded to the Azure Maps Data Service.\n\nYou can use this API in a scenario like uploading a DWG zip package for a building, converting the zip package using \nthe Azure Maps Conversion Service, creating a dataset from the converted zip package. The created dataset can be \nused to create tilesets using the Azure Maps Tileset Service and can be queried via the Azure Maps WFS Service.\n\n## Submit Create Request\n\nTo create your dataset, you will use a `POST` request where the `conversionId` query parameter is an id that represents \nthe converted DWG zip package, the `type` parameter will describe the data type to use for the dataset, the `datasetId`\nparameter will describe if the provided data should be appended to a current dataset and, optionally, the \n`description` query parameter will contain a description (if description is not provided a default description will be \ngiven).\n\nThe Create API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
"operationId": "Dataset_CreatePreview",
"x-ms-long-running-operation": true,
"x-ms-long-running-operation-options": {
@@ -287,7 +321,7 @@
"/dataset/import/{datasetId}": {
"patch": {
"x-publish": true,
- "description": "**Dataset Import API**\n\n**Applies to:** S1 pricing tier.\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. The Dataset APIs are part of Creator. This API allows the caller to bulk import data into a dataset \nfrom data that was uploaded to the Azure Maps Data service.
\n\n### Submit Import Request\n\nTo import data into your dataset, you will use a `PATCH` request where the `datasetId` query parameter is the \ndataset you want to import your data into, the `udid` query parameter is the data you want to import, and the `type` \nparameter will describe the data type to use for the import data.
\n\nThe Import API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
+ "description": "**Dataset Import API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. The Dataset APIs are part of Creator. This API allows the caller to bulk import data into a dataset \nfrom data that was uploaded to the Azure Maps Data service.
\n\n### Submit Import Request\n\nTo import data into your dataset, you will use a `PATCH` request where the `datasetId` query parameter is the \ndataset you want to import your data into, the `udid` query parameter is the data you want to import, and the `type` \nparameter will describe the data type to use for the import data.
\n\nThe Import API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
"operationId": "Dataset_ImportPreview",
"x-ms-examples": {
"Import data into previously created dataset": {
@@ -339,7 +373,7 @@
"/dataset/{datasetId}": {
"delete": {
"x-publish": true,
- "description": "**Dataset Delete API**\n\n**Applies to:** S1 pricing tier.\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Dataset APIs are part of Creator.\nThis API allows the caller to delete a previously created dataset.
\nYou can also use this API to delete old/unused datasets to create space for new Creator content.\n\n\n### Submit Delete Request\n\nTo delete your content you will issue a `DELETE` request where the path will contain the `datasetId` of the dataset to delete.
\n\n\n### Delete Data Response\n\nThe Delete API returns a HTTP `204 No Content` response if the dataset resource was deleted successfully.
",
+ "description": "**Dataset Delete API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Dataset APIs are part of Creator.\nThis API allows the caller to delete a previously created dataset.
\nYou can also use this API to delete old/unused datasets to create space for new Creator content.\n\n\n### Submit Delete Request\n\nTo delete your content you will issue a `DELETE` request where the path will contain the `datasetId` of the dataset to delete.
\n\n\n### Delete Data Response\n\nThe Delete API returns a HTTP `204 No Content` response if the dataset resource was deleted successfully.
",
"operationId": "Dataset_DeletePreview",
"x-ms-examples": {
"Delete previously created dataset": {
@@ -385,7 +419,7 @@
"/dataset": {
"get": {
"x-publish": true,
- "description": "**Dataset List API**\n\n**Applies to:** S1 pricing tier.\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Dataset APIs are part of Creator.\nThis API allows the caller to fetch a list of all previously successfully created datasets.\n\n\n### Submit List Request\n\nTo list all your datasets, you will issue a `GET` request with no additional parameters.
\n\n\n### List Data Response\n\nThe List API returns the complete list of all datasets in `json` format. The response contains the following fields (if they are not null or empty):\n > created - The timestamp the dataset was created.\n > datasetId - The id for the dataset.\n > description - The description for the dataset.\n > datasetSources - The source data that was used when the create request was issued.\n\nThe `datasetSources` describes the source data that was used when the create request was issued and contains the following elements (if they are not null or empty):\n > conversionIds - The list of `conversionId` (null if none were provided).\n > udids - The list of `udid` (null if none were provided).\n > appendDatasetId - The `datasetId` that was used for an append operation (null if none was used).\n > type - The type of data stored in the dataset that was created.\n\nHere's a sample response returning the `timestamp`, `datasetId`, `description`, and `datasetSources` of 3 dataset resources:\n\n
\n\n```json\n{\n \"datasets\": [\n {\n \"timestamp\": \"2020-01-01T22:50:48+00:00\",\n \"datasetId\": \"f6495f62-94f8-0ec2-c252-45626f82fcb2\",\n \"description\": \"Some description or comment for the dataset.\",\n \"datasetSources\": {\n \"conversionIds\": [\n \"15d21452-c9bb-27b6-5e79-743ca5c3205d\"\n ],\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n },\n {\n \"timestamp\": \"2020-01-01T22:57:53+00:00\",\n \"datasetId\": \"8b1288fa-1958-4a2b-b68e-13a7i5af7d7c\",\n \"description\": \"Create from upload '0c1288fa-2058-4a1b-b68d-13a5f5af7d7c'.\",\n \"datasetSources\": {\n \"udids\": [\n \"0c1288fa-2058-4a1b-b68d-13a5f5af7d7c\"\n ],\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n },\n {\n \"timestamp\": \"2020-01-01T20:39:36+00:00\",\n \"datasetId\": \"7c1288fa-2058-4a1b-b68f-13a6h5af7d7c\",\n \"description\": \"Some other description or comment for the dataset.\",\n \"datasetSources\": {\n \"conversionIds\": [\n \"15d21452-c9bb-27b6-5e79-743ca5c3205d\"\n ],\n \"appendDatasetId\": \"8b1288fa-1958-4a2b-b68e-13a7i5af7d7c\",\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n }\n ]\n}\n```\n
",
+ "description": "**Dataset List API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Dataset APIs are part of Creator.\nThis API allows the caller to fetch a list of all previously successfully created datasets.\n\n\n### Submit List Request\n\nTo list all your datasets, you will issue a `GET` request with no additional parameters.
\n\n\n### List Data Response\n\nThe List API returns the complete list of all datasets in `json` format. The response contains the following fields (if they are not null or empty):\n > created - The timestamp the dataset was created.\n > datasetId - The id for the dataset.\n > description - The description for the dataset.\n > datasetSources - The source data that was used when the create request was issued.\n\nThe `datasetSources` describes the source data that was used when the create request was issued and contains the following elements (if they are not null or empty):\n > conversionIds - The list of `conversionId` (null if none were provided).\n > udids - The list of `udid` (null if none were provided).\n > appendDatasetId - The `datasetId` that was used for an append operation (null if none was used).\n > type - The type of data stored in the dataset that was created.\n\nHere's a sample response returning the `timestamp`, `datasetId`, `description`, and `datasetSources` of 3 dataset resources:\n\n
\n\n```json\n{\n \"datasets\": [\n {\n \"timestamp\": \"2020-01-01T22:50:48+00:00\",\n \"datasetId\": \"f6495f62-94f8-0ec2-c252-45626f82fcb2\",\n \"description\": \"Some description or comment for the dataset.\",\n \"datasetSources\": {\n \"conversionIds\": [\n \"15d21452-c9bb-27b6-5e79-743ca5c3205d\"\n ],\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n },\n {\n \"timestamp\": \"2020-01-01T22:57:53+00:00\",\n \"datasetId\": \"8b1288fa-1958-4a2b-b68e-13a7i5af7d7c\",\n \"description\": \"Create from upload '0c1288fa-2058-4a1b-b68d-13a5f5af7d7c'.\",\n \"datasetSources\": {\n \"udids\": [\n \"0c1288fa-2058-4a1b-b68d-13a5f5af7d7c\"\n ],\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n },\n {\n \"timestamp\": \"2020-01-01T20:39:36+00:00\",\n \"datasetId\": \"7c1288fa-2058-4a1b-b68f-13a6h5af7d7c\",\n \"description\": \"Some other description or comment for the dataset.\",\n \"datasetSources\": {\n \"conversionIds\": [\n \"15d21452-c9bb-27b6-5e79-743ca5c3205d\"\n ],\n \"appendDatasetId\": \"8b1288fa-1958-4a2b-b68e-13a7i5af7d7c\",\n \"type\": \"facility\"\n },\n \"status\": \"Succeeded\"\n }\n ]\n}\n```\n
",
"operationId": "Dataset_ListPreview",
"x-ms-examples": {
"List all the previously created datasets": {
diff --git a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Create.json b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Create.json
index 6d8513252576..e59db5d0820e 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Create.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Create.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"conversionId": "[conversionId]",
@@ -8,19 +9,19 @@
"responses": {
"201": {
"headers": {
- "Location": "https://atlas.microsoft.com/dataset/{datasetId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/dataset/{datasetId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
},
"body": {
"operationId": "{operationId}",
"status": "Succeeded",
"created": "2020-01-02 1:02:03 AM +00:00",
- "resourceLocation": "https://atlas.microsoft.com/dataset/{datasetId}?api-version=1.0"
+ "resourceLocation": "https://us.atlas.microsoft.com/dataset/{datasetId}?api-version=1.0"
}
},
"202": {
"headers": {
- "Location": "https://atlas.microsoft.com/dataset/operations/{operationId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/dataset/operations/{operationId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
}
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Delete.json b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Delete.json
index 3ad9cf60de1c..865652b9cbd8 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Delete.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Delete.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"datasetId": "[datasetId]"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Import.json b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Import.json
index fa4cb9ca8950..074bd5c20371 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Import.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_Import.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"datasetId": "[conversionId]",
@@ -13,12 +14,12 @@
"operationId": "{operationId}",
"status": "Succeeded",
"created": "2020-01-02 03:04:05 AM +00:00",
- "resourceLocation": "https://atlas.microsoft.com/dataset/{datasetId}?api-version=1.0"
+ "resourceLocation": "https://us.atlas.microsoft.com/dataset/{datasetId}?api-version=1.0"
}
},
"202": {
"headers": {
- "Location": "https://atlas.microsoft.com/dataset/operations/{operationId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/dataset/operations/{operationId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
}
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_List.json b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_List.json
index 4937c40e2e95..70a28edebb38 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Dataset/preview/1.0/examples/Dataset_List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/dwgconversion.json b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/dwgconversion.json
index df01ad77d8df..227ec56ce6ce 100644
--- a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/dwgconversion.json
+++ b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/dwgconversion.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for converting DWG Packages in Azure Maps."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -98,6 +105,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"ClientId": {
"name": "x-ms-client-id",
"description": "Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from Azure Maps management plane Account API. To use Azure AD security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.",
@@ -173,7 +207,7 @@
"/conversion/convert": {
"post": {
"x-publish": true,
- "description": "**Conversion Create API**\n\n**Applies to:** S1 pricing tier.
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and \nSDK. The Conversion API is part of Creator.
\n\nThe Conversion API lets the caller import a set of DWG design files as a zipped [Drawing Package](https://aka.ms/am-drawing-package) into Azure Maps. The [Drawing Package](https://aka.ms/am-drawing-package) should first be \nuploaded using the [Azure Maps Data Service](https://docs.microsoft.com/rest/api/maps/data). Once uploaded, use the \n`udid` returned by the [Data Upload API](https://docs.microsoft.com/rest/api/maps/data/uploadpreview) to call \nthis Conversion API.\n\n## Convert DWG package\n\nThe Conversion API performs a \n[long-running request](https://aka.ms/am-creator-lrt).\n\n## Debug DWG package issues\n\n\nDuring the Conversion process, if there are any issues with the DWG package [errors and warnings](https://aka.ms/am-conversion-errors) are provided in the response along with a *diagnostic package* to visualize \nand diagnose these issues. In case any issues are encountered with your DWG package, the Conversion operation status process as detailed \n[here](https://aka.ms/am-creator-lrt) returns the location of the *diagnostic\npackage* that can be downloaded by the caller to help them visualize and diagnose these issues. The *diagnostic package* location\ncan be found in the properties section of the conversion operation status response and looks like the following:\n\n```json\n{\n \"properties\": {\n \"diagnosticPackageLocation\": \"https://atlas.microsoft.com/mapdata/{DiagnosticPackageId}?api-version=1.0\" \n } \n}\n```\n\nThe *diagnostic package* can be downloaded by executing a `HTTP GET` request on the `diagnosticPackageLocation`.\nFor more details on how to use the tool to visualize and diagnose all the errors and warnings see [Drawing Error Visualizer](https://aka.ms/am-drawing-errors-visualizer).
\n\nA conversion operation will be marked as *success* if there are zero or more warnings but will be marked as *failed* if any errors are encountered. ",
+ "description": "**Conversion Create API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and \nSDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.
\n\nThe Conversion API lets the caller import a set of DWG design files as a zipped [Drawing Package](https://aka.ms/am-drawing-package) into Azure Maps. The [Drawing Package](https://aka.ms/am-drawing-package) should first be \nuploaded using the [Azure Maps Data Service](https://docs.microsoft.com/rest/api/maps/data). Once uploaded, use the \n`udid` returned by the [Data Upload API](https://docs.microsoft.com/rest/api/maps/data/uploadpreview) to call \nthis Conversion API.\n\n## Convert DWG package\n\nThe Conversion API performs a \n[long-running request](https://aka.ms/am-creator-lrt).\n\n## Debug DWG package issues\n\n\nDuring the Conversion process, if there are any issues with the DWG package [errors and warnings](https://aka.ms/am-conversion-errors) are provided in the response along with a *diagnostic package* to visualize \nand diagnose these issues. In case any issues are encountered with your DWG package, the Conversion operation status process as detailed \n[here](https://aka.ms/am-creator-lrt) returns the location of the *diagnostic\npackage* that can be downloaded by the caller to help them visualize and diagnose these issues. The *diagnostic package* location\ncan be found in the properties section of the conversion operation status response and looks like the following:\n\n```json\n{\n \"properties\": {\n \"diagnosticPackageLocation\": \"https://us.atlas.microsoft.com/mapdata/{DiagnosticPackageId}?api-version=1.0\" \n } \n}\n```\n\nThe *diagnostic package* can be downloaded by executing a `HTTP GET` request on the `diagnosticPackageLocation`.\nFor more details on how to use the tool to visualize and diagnose all the errors and warnings see [Drawing Error Visualizer](https://aka.ms/am-drawing-errors-visualizer).
\n\nA conversion operation will be marked as *success* if there are zero or more warnings but will be marked as *failed* if any errors are encountered. ",
"operationId": "Conversion_ConvertPreview",
"x-ms-long-running-operation": true,
"x-ms-long-running-operation-options": {
@@ -232,7 +266,7 @@
"/conversion": {
"get": {
"x-publish": true,
- "description": "**Conversion List API**\n\n**Applies to:** S1 pricing tier.
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Conversion API is part of Creator.
\n\nThis API allows the caller to fetch a list of all successful data conversions submitted previously using the [Conversion API](https://docs.microsoft.com/en-us/rest/api/maps/conversion/convertpreview). \n\n### Submit List Request\n\nTo list all successful conversions you will issue a `GET` request with no additional parameters.\n\n### List Data Response\n\nThe Conversion List API returns the complete list of all conversion details in `json` format.
\n\nHere is a sample response returning the details of two successful conversion requests: \n\n
\n\n```json\n{\n \"conversions\": \n [\n {\n \"conversionId\": \"54398242-ea6c-1f31-4fa6-79b1ae0fc24d\",\n \"udid\": \"31838736-8b84-11ea-bc55-0242ac130003\",\n \"created\": \"5/19/2020 9:00:00 AM +00:00\",\n \"description\": \"User provided description.\",\n \"featureCounts\": {\n \"DIR\": 1,\n \"LVL\": 3,\n \"FCL\": 1,\n \"UNIT\": 150,\n \"CTG\": 8,\n \"AEL\": 0,\n \"OPN\": 10\n }\n },\n {\n \"conversionId\": \"2acf7d32-8b84-11ea-bc55-0242ac130003\",\n \"udid\": \"1214bc58-8b84-11ea-bc55-0242ac1300039\",\n \"created\": \"5/19/2020 9:00:00 AM +00:00\",\n \"description\": \"User provided description.\",\n \"featureCounts\": {\n \"DIR\": 1,\n \"LVL\": 3,\n \"FCL\": 1,\n \"UNIT\": 150,\n \"CTG\": 8,\n \"AEL\": 0,\n \"OPN\": 10\n }\n }\n ]\n}\n```\n\n
",
+ "description": "**Conversion List API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.
\n\nThis API allows the caller to fetch a list of all successful data conversions submitted previously using the [Conversion API](https://docs.microsoft.com/en-us/rest/api/maps/conversion/convertpreview). \n\n### Submit List Request\n\nTo list all successful conversions you will issue a `GET` request with no additional parameters.\n\n### List Data Response\n\nThe Conversion List API returns the complete list of all conversion details in `json` format.
\n\nHere is a sample response returning the details of two successful conversion requests: \n\n
\n\n```json\n{\n \"conversions\": \n [\n {\n \"conversionId\": \"54398242-ea6c-1f31-4fa6-79b1ae0fc24d\",\n \"udid\": \"31838736-8b84-11ea-bc55-0242ac130003\",\n \"created\": \"5/19/2020 9:00:00 AM +00:00\",\n \"description\": \"User provided description.\",\n \"featureCounts\": {\n \"DIR\": 1,\n \"LVL\": 3,\n \"FCL\": 1,\n \"UNIT\": 150,\n \"CTG\": 8,\n \"AEL\": 0,\n \"OPN\": 10\n }\n },\n {\n \"conversionId\": \"2acf7d32-8b84-11ea-bc55-0242ac130003\",\n \"udid\": \"1214bc58-8b84-11ea-bc55-0242ac1300039\",\n \"created\": \"5/19/2020 9:00:00 AM +00:00\",\n \"description\": \"User provided description.\",\n \"featureCounts\": {\n \"DIR\": 1,\n \"LVL\": 3,\n \"FCL\": 1,\n \"UNIT\": 150,\n \"CTG\": 8,\n \"AEL\": 0,\n \"OPN\": 10\n }\n }\n ]\n}\n```\n\n
",
"operationId": "Conversion_ListPreview",
"x-ms-examples": {
"Returns a list of all the data processed by the Conversion Service for the account": {
@@ -278,7 +312,7 @@
"/conversion/{conversionId}": {
"delete": {
"x-publish": true,
- "description": "**Conversion Delete API**\n\n**Applies to:** S1 pricing tier.
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Delete API is part of Creator.
\n\nThis API allows the caller to delete any data conversions created previously using the [Conversion API](https://docs.microsoft.com/en-us/rest/api/maps/conversion/convertpreview).\n\n### Submit Delete Request\n\nTo delete your conversion data you will issue a `DELETE` request where the path will contain the `conversionId` of the data to delete.\n\n### Conversion Delete Response\n\nThe Conversion Delete API returns a HTTP `204 No Content` response with an empty body, if the converted data resources were deleted successfully.
\nA HTTP `400 Bad Request` error response will be returned if no resource associated with the passed-in `conversionId` is found. ",
+ "description": "**Conversion Delete API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.
\n\nThis API allows the caller to delete any data conversions created previously using the [Conversion API](https://docs.microsoft.com/en-us/rest/api/maps/conversion/convertpreview).\n\n### Submit Delete Request\n\nTo delete your conversion data you will issue a `DELETE` request where the path will contain the `conversionId` of the data to delete.\n\n### Conversion Delete Response\n\nThe Conversion Delete API returns a HTTP `204 No Content` response with an empty body, if the converted data resources were deleted successfully.
\nA HTTP `400 Bad Request` error response will be returned if no resource associated with the passed-in `conversionId` is found. ",
"operationId": "Conversion_DeletePreview",
"x-ms-examples": {
"Delete previously converted content": {
diff --git a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Conversion.json b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Conversion.json
index b9af945a36d8..620928efd64a 100644
--- a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Conversion.json
+++ b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Conversion.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"udid": "25084fb7-307a-4720-8f91-7952a0b91012",
@@ -8,19 +9,19 @@
"responses": {
"201": {
"headers": {
- "Location": "https://atlas.microsoft.com/conversion/{conversionId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/conversion/{conversionId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
},
"body": {
"operationId": "{operationId}",
"status": "Succeeded",
"created": "2020-01-02 1:02:03 AM +00:00",
- "resourceLocation": "https://atlas.microsoft.com/conversion/{conversionId}?api-version=1.0"
+ "resourceLocation": "https://us.atlas.microsoft.com/conversion/{conversionId}?api-version=1.0"
}
},
"202": {
"headers": {
- "Location": "https://atlas.microsoft.com/conversion/operations/{operationId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/conversion/operations/{operationId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
}
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Delete.json b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Delete.json
index a0858462d16c..a2437b22c532 100644
--- a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Delete.json
+++ b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/Delete.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"conversionId": "99884fb7-87a9-0920-7f93-7952a0b91012"
diff --git a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/List.json b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/List.json
index 357a0d0ab352..2b7782a6acf3 100644
--- a/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/DwgConversion/preview/1.0/examples/List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/CreateStateset.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/CreateStateset.json
index 4867a31308b1..26077a93784b 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/CreateStateset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/CreateStateset.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"datasetId": "5d34fbe8-87b7-f7c0-3144-c50e003a3c75",
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteFeatureState.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteFeatureState.json
index 86a97a62d209..4fae12773bc9 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteFeatureState.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteFeatureState.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64",
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteStateset.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteStateset.json
index e6bf9ebe20a6..18a62b07b2d0 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteStateset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/DeleteStateset.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64f"
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStates.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStates.json
index e581ce3b7b5d..0f83e1814041 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStates.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStates.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64",
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStateset.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStateset.json
index 5d2a45831fbf..655b55546d1c 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStateset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/GetStateset.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64"
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/Stateset_List.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/Stateset_List.json
index bf547d808b57..94eede94963b 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/Stateset_List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/Stateset_List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStates.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStates.json
index d19d997f16f9..a2e115192cc9 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStates.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStates.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64",
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStateset.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStateset.json
index e540bcda431a..02d4c988a0a1 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStateset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/examples/UpdateStateset.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"statesetId": "b24bdb73-1305-3212-1909-a428d937b64",
diff --git a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/featurestate.json b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/featurestate.json
index 5f16128d33da..df8b036ffb72 100644
--- a/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/featurestate.json
+++ b/specification/maps/data-plane/Microsoft.Maps/FeatureState/preview/1.0/featurestate.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for managing the dynamic feature states in Azure Maps."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -83,6 +90,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"SubscriptionKey": {
"name": "subscription-key",
"description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.",
@@ -161,7 +195,7 @@
"/featureState/stateset/{statesetId}": {
"get": {
"x-publish": true,
- "description": "**Applies to:** S1 pricing tier.\n
\n\nThis GET API allows the user to get the stateset Information.\n\nThe stateset Information includes the datasetId associated to the stateset, and the styles of that stateset.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis GET API allows the user to get the stateset Information.\n\nThe stateset Information includes the datasetId associated to the stateset, and the styles of that stateset.",
"operationId": "FeatureState_GetStatesetPreview",
"x-ms-examples": {
"Get stateset information with a statesetId": {
@@ -205,7 +239,7 @@
},
"delete": {
"x-publish": true,
- "description": "**Applies to:** S1 pricing tier.
This DELETE API allows the user to delete the stateset and the associated data.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
This DELETE API allows the user to delete the stateset and the associated data.",
"operationId": "FeatureState_DeleteStatesetPreview",
"x-ms-examples": {
"Delete an existing stateset": {
@@ -246,7 +280,7 @@
},
"put": {
"x-publish": true,
- "description": "**Applies to:** S1 pricing tier.\n
\n\nThis PUT API allows the user to update the stateset style rules.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis PUT API allows the user to update the stateset style rules.",
"operationId": "FeatureState_PutStatesetPreview",
"x-ms-examples": {
"Update stateset style rules with a statesetId": {
@@ -298,7 +332,7 @@
"/featureState/stateset": {
"post": {
"x-publish": true,
- "description": "**Applies to:** S1 pricing tier.\n
\n\nThis POST API allows the user to create a new Stateset and define stateset style using request body.\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Feature State API is part of Creator. \n\nThe Feature State service allows the user to update the states of a feature and query them to be used in other services. The dynamic properties of a feature that don't belong to the dataset are referred to as *states* here.\n\nThis Feature State service pivot on the Stateset. Like Tileset, Stateset encapsulates the storage mechanism for feature states for a dataset.\n\nOnce the stateset is created, users can use that statesetId to post feature state updates and retrieve the current feature states. A feature can have only one state at a given point in time. \n\nFeature state is defined by the key name, value and the timestamp. When a feature state update is posted to Azure Maps, the state value gets updated only if the provided state’s timestamp is later than the stored timestamp. \n\nAzure Maps MapControl provides a way to use these feature states to style the features. Please refer to the State Tile documentation for more information.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nThis POST API allows the user to create a new Stateset and define stateset style using request body.\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Feature State API is part of Creator. \n\nThe Feature State service allows the user to update the states of a feature and query them to be used in other services. The dynamic properties of a feature that don't belong to the dataset are referred to as *states* here.\n\nThis Feature State service pivot on the Stateset. Like Tileset, Stateset encapsulates the storage mechanism for feature states for a dataset.\n\nOnce the stateset is created, users can use that statesetId to post feature state updates and retrieve the current feature states. A feature can have only one state at a given point in time. \n\nFeature state is defined by the key name, value and the timestamp. When a feature state update is posted to Azure Maps, the state value gets updated only if the provided state’s timestamp is later than the stored timestamp. \n\nAzure Maps MapControl provides a way to use these feature states to style the features. Please refer to the State Tile documentation for more information.",
"operationId": "FeatureState_CreateStatesetPreview",
"x-ms-examples": {
"Create a new stateset with a datasetId": {
@@ -351,7 +385,7 @@
},
"get": {
"x-publish": true,
- "description": "**Applies to:** S1 pricing tier.
This API allows the caller to fetch a list of all previously successfully created statesets.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
This API allows the caller to fetch a list of all previously successfully created statesets.",
"operationId": "FeatureState_ListStatesetPreview",
"x-ms-examples": {
"List all the previously created statesets": {
@@ -395,7 +429,7 @@
"get": {
"x-publish": true,
"operationId": "FeatureState_GetStatesPreview",
- "description": "**Applies to:** S1 pricing tier.
This API returns the current state information associated with the given feature in the given stateset.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
This API returns the current state information associated with the given feature in the given stateset.",
"x-ms-examples": {
"Get the current states of a feature": {
"$ref": "./examples/GetStates.json"
@@ -442,7 +476,7 @@
"post": {
"x-publish": true,
"operationId": "FeatureState_UpdateStatesPreview",
- "description": "**Applies to:** S1 pricing tier.
\nThis POST API allows the user to update the state of the given feature in the given stateset.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
\nThis POST API allows the user to update the state of the given feature in the given stateset.",
"x-ms-examples": {
"Update the states of a feature": {
"$ref": "./examples/UpdateStates.json"
@@ -495,7 +529,7 @@
"delete": {
"x-publish": true,
"operationId": "FeatureState_DeleteStatePreview",
- "description": "**Applies to:** S1 pricing tier.
This API deletes the state information identified by the StateKeyName parameter for the feature identified by the FeatureId parameter in the the stateset.",
+ "description": "**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).
This API deletes the state information identified by the StateKeyName parameter for the feature identified by the FeatureId parameter in the the stateset.",
"x-ms-examples": {
"Delete the given feature state": {
"$ref": "./examples/DeleteFeatureState.json"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Create.json b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Create.json
index 8767d242b699..d95ef6727f62 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Create.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Create.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"datasetId": "[dataset-Id]"
@@ -7,19 +8,19 @@
"responses": {
"201": {
"headers": {
- "Location": "https://atlas.microsoft.com/tileset/{tilesetId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/tileset/{tilesetId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
},
"body": {
"operationId": "{operationId}",
"status": "Succeeded",
"created": "2020-01-02 1:02:03 AM +00:00",
- "resourceLocation": "https://atlas.microsoft.com/tileset/{tilesetId}?api-version=1.0"
+ "resourceLocation": "https://us.atlas.microsoft.com/tileset/{tilesetId}?api-version=1.0"
}
},
"202": {
"headers": {
- "Location": "https://atlas.microsoft.com/tileset/operations/{operationId}?api-version=1.0",
+ "Location": "https://us.atlas.microsoft.com/tileset/operations/{operationId}?api-version=1.0",
"Access-Control-Expose-Headers": "Location"
}
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Delete.json b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Delete.json
index 8f36f5a7d813..645e0fcb102b 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Delete.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/Delete.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]",
"tilesetId": "25084fb7-307a-4720-8f91-7952a0b91012"
diff --git a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/List.json b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/List.json
index 382cb4025edf..ec95c2ccc02e 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/List.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/examples/List.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"subscription-key": "[subscription-key]"
},
diff --git a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/tileset.json b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/tileset.json
index 9960c7dd7251..804c435ff954 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/tileset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/1.0/tileset.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "APIs for managing Tilesets."
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -98,6 +105,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"ClientId": {
"name": "x-ms-client-id",
"description": "Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from Azure Maps management plane Account API. To use Azure AD security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.",
@@ -173,7 +207,7 @@
"/tileset/create/vector": {
"post": {
"x-publish": true,
- "description": "**Tileset Create API**\n\n**Applies to**: S1 pricing tier.\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. The Tileset API is part of Creator.\n\nThe Tileset Create API allows the caller to create a tileset from a dataset. A tileset contains a set of tiles that can be consumed \nfrom the [Get Map Tile](/rest/api/maps/render/getmaptile) to retrieve custom tiles. To make a dataset, use the \n[DataSet Create API](/rest/api/maps/dataset/createpreview).\n\n## Submit Create Request\n\nTo create your tileset you will make a `POST` request with an empty body. The `datasetId` query parameter will be \nused as the source of the tileset data.\n\nThe Create Tileset API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
+ "description": "**Tileset Create API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API \nand SDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\nThe Tileset Create API allows the caller to create a tileset from a dataset. A tileset contains a set of tiles that can be consumed \nfrom the [Get Map Tile](/rest/api/maps/render/getmaptile) to retrieve custom tiles. To make a dataset, use the \n[DataSet Create API](/rest/api/maps/dataset/createpreview).\n\n## Submit Create Request\n\nTo create your tileset you will make a `POST` request with an empty body. The `datasetId` query parameter will be \nused as the source of the tileset data.\n\nThe Create Tileset API is a \n[long-running request](https://aka.ms/am-creator-lrt).",
"operationId": "Tileset_CreatePreview",
"x-ms-long-running-operation": true,
"x-ms-long-running-operation-options": {
@@ -229,7 +263,7 @@
"/tileset": {
"get": {
"x-publish": true,
- "description": "**Tileset List API**\n\n**Applies to:** S1 pricing tier.\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Tileset API is part of Creator.\nThis API allows the caller to fetch a list of all tilesets created. \n
",
+ "description": "**Tileset List API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\nThis API allows the caller to fetch a list of all tilesets created. \n
",
"operationId": "Tileset_ListPreview",
"x-ms-examples": {
"Get a list of all tilesets": {
@@ -275,7 +309,7 @@
"/tileset/{tilesetId}": {
"delete": {
"x-publish": true,
- "description": "**Tileset Delete API**\n\n**Applies to:** S1 pricing tier.\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. The Tileset API is part of Creator.\nThis API allows the caller to delete a created tileset.
\nYou can use this API if a tileset is no longer needed. \n\n### Submit Delete Request\n\nTo delete your content you will issue a `DELETE` request where the path will contain the `tilesetId` of the tileset to delete.
\n\n#### Delete request \"Successful\"\n\nThe Tileset Delete API returns a HTTP `204 No Content` response with an empty body, if the tileset was deleted successfully.
\n\n#### Delete request \"Failed\"\n\nA HTTP `400 Bad Request` error response will be returned if the tileset with the passed-in `tilesetId` is not found. \n\nHere is a sample error response:\n\n
\n\n```json\n{\n \"error\": {\n \"code\": \"400 BadRequest\",\n \"message\": \"Bad request - Tileset Id: d85b5b27-5fc4-4599-8b50-47160e90f8ce does not exist.\"\n }\n}\n```",
+ "description": "**Tileset Delete API**\n\n**Applies to**: see pricing [tiers](https://azure.microsoft.com/en-us/pricing/details/azure-maps/).\n
\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\nThis API allows the caller to delete a created tileset.
\nYou can use this API if a tileset is no longer needed. \n\n### Submit Delete Request\n\nTo delete your content you will issue a `DELETE` request where the path will contain the `tilesetId` of the tileset to delete.
\n\n#### Delete request \"Successful\"\n\nThe Tileset Delete API returns a HTTP `204 No Content` response with an empty body, if the tileset was deleted successfully.
\n\n#### Delete request \"Failed\"\n\nA HTTP `400 Bad Request` error response will be returned if the tileset with the passed-in `tilesetId` is not found. \n\nHere is a sample error response:\n\n
\n\n```json\n{\n \"error\": {\n \"code\": \"400 BadRequest\",\n \"message\": \"Bad request - Tileset Id: d85b5b27-5fc4-4599-8b50-47160e90f8ce does not exist.\"\n }\n}\n```",
"operationId": "Tileset_DeletePreview",
"x-ms-examples": {
"Delete a created tileset": {
diff --git a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/2.0/tileset.json b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/2.0/tileset.json
index 6c4427b04e8e..5c44d0fe5382 100644
--- a/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/2.0/tileset.json
+++ b/specification/maps/data-plane/Microsoft.Maps/Tileset/preview/2.0/tileset.json
@@ -215,7 +215,7 @@
"/tilesets": {
"post": {
"x-publish": true,
- "description": "**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\n The Tileset API is part of Creator.\n\nThe Tileset Create API allows the caller to create a tileset from a dataset. A tileset contains a set of tiles that can be consumed \nfrom the [Get Map Tile](/rest/api/maps/render/getmaptile) to retrieve custom tiles. To make a dataset, use the \n[DataSet Create API](/rest/api/maps/dataset/createpreview).\n\n## Submit Create Request\n\nTo create your tileset you will make a `POST` request with an empty body. The `datasetId` query parameter will be \nused as the source of the tileset data.\n\nThe Create Tileset API is a \n[long-running request](https://aka.ms/am-creator-lrt-v2).",
+ "description": "**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\n [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\nThe Tileset Create API allows the caller to create a tileset from a dataset. A tileset contains a set of tiles that can be consumed \nfrom the [Get Map Tile](/rest/api/maps/render/getmaptile) to retrieve custom tiles. To make a dataset, use the \n[DataSet Create API](/rest/api/maps/dataset/createpreview).\n\n## Submit Create Request\n\nTo create your tileset you will make a `POST` request with an empty body. The `datasetId` query parameter will be \nused as the source of the tileset data.\n\nThe Create Tileset API is a \n[long-running request](https://aka.ms/am-creator-lrt-v2).",
"operationId": "Tileset_Create",
"x-ms-examples": {
"Create Tileset by providing a Dataset Id": {
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/DeleteItem.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/DeleteItem.json
index 127a25dc1639..72fdf9389540 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/DeleteItem.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/DeleteItem.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]",
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollection.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollection.json
index 583b150414ee..289c2decdf0c 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollection.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollection.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]",
@@ -12,17 +13,17 @@
"description": "A physical and non-overlapping area which might be occupied and traversed by a navigating agent. Can be a hallway, a room, a courtyard, etc. It is surrounded by physical obstruction (wall), unless the isOpenArea attribute is equal to true, and one must add openings where the obstruction shouldn't be there. If isOpenArea attribute is equal to true, all the sides are assumed open to the surroundings and walls are to be added where needed. Walls for open areas are represented as a lineElement or areaElement with isObstruction equal to true.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for unit"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
"rel": "data",
"title": "unit"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for unit"
}
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollectionDefinition.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollectionDefinition.json
index e4d17ccf6650..5abb684137ba 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollectionDefinition.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollectionDefinition.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]",
@@ -135,12 +136,12 @@
],
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for unit"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
"rel": "data",
"title": "unit"
}
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollections.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollections.json
index 7048a3299237..c66647770907 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollections.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetCollections.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]"
@@ -13,17 +14,17 @@
"description": "A physical and non-overlapping area which might be occupied and traversed by a navigating agent. Can be a hallway, a room, a courtyard, etc. It is surrounded by physical obstruction (wall), unless the isOpenArea attribute is equal to true, and one must add openings where the obstruction shouldn't be there. If isOpenArea attribute is equal to true, all the sides are assumed open to the surroundings and walls are to be added where needed. Walls for open areas are represented as a lineElement or areaElement with isObstruction equal to true.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for unit"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0",
"rel": "data",
"title": "unit"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for unit"
}
@@ -34,17 +35,17 @@
"description": "A virtual area. ex, wifi zone, emergency assembly area. Zones can be used as destinations but not meant for through traffic.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for zone"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone/items?api-version=1.0",
"rel": "data",
"title": "zone"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/zone?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for zone"
}
@@ -55,17 +56,17 @@
"description": "An indication of the extent and vertical position of a set of features.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for level"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level/items?api-version=1.0",
"rel": "data",
"title": "level"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/level?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for level"
}
@@ -76,17 +77,17 @@
"description": "Area of the site, building footprint etc.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for facility"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility/items?api-version=1.0",
"rel": "data",
"title": "facility"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/facility?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for facility"
}
@@ -97,17 +98,17 @@
"description": "An area that, when used in a set, represents a method of navigating vertically between levels. It can be used to model stairs, elevators etc. Geometry can overlap units and other vertical penetration features.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for verticalPenetration"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration/items?api-version=1.0",
"rel": "data",
"title": "verticalPenetration"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/verticalPenetration?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for verticalPenetration"
}
@@ -118,17 +119,17 @@
"description": "A usually-traversable boundary between two units, or a unit and verticalPenetration.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for opening"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening/items?api-version=1.0",
"rel": "data",
"title": "opening"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/opening?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for opening"
}
@@ -139,17 +140,17 @@
"description": "Name, address, phone number, website, and hours of operation for a unit, facility, or an occupant of a unit or facility.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for directoryInfo"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo/items?api-version=1.0",
"rel": "data",
"title": "directoryInfo"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/directoryInfo?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for directoryInfo"
}
@@ -160,17 +161,17 @@
"description": "A point feature in a unit, such as a first aid kit or a sprinkler head.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for pointElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement/items?api-version=1.0",
"rel": "data",
"title": "pointElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/pointElement?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for pointElement"
}
@@ -181,17 +182,17 @@
"description": "A line feature in a unit, such as a dividing wall, window.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for lineElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement/items?api-version=1.0",
"rel": "data",
"title": "lineElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/lineElement?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for lineElement"
}
@@ -202,17 +203,17 @@
"description": "A polygon feature in a unit, such as an area open to below, an obstruction like an island in a unit.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for areaElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement/items?api-version=1.0",
"rel": "data",
"title": "areaElement"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/areaElement?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for areaElement"
}
@@ -223,17 +224,17 @@
"description": "Category names. e.g. \"room.conference\". The isRoutable attribute puts a feature with that category on the routing graph. The routeThroughBehavior attribute determines whether a feature can be used for through traffic or not.",
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category/definition?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category/definition?api-version=1.0",
"rel": "describedBy",
"title": "Metadata catalogue for category"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category/items?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category/items?api-version=1.0",
"rel": "data",
"title": "category"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/category?api-version=1.0",
"rel": "self",
"title": "Metadata catalogue for category"
}
@@ -242,7 +243,7 @@
],
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections?api-version=1.0",
"rel": "self"
}
]
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetConformance.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetConformance.json
index 2087dca71fe4..48086e702d21 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetConformance.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetConformance.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]"
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItem.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItem.json
index a83972b09aa0..20f6305c4e7e 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItem.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItem.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]",
@@ -69,11 +70,11 @@
},
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items/UNIT39?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items/UNIT39?api-version=1.0",
"rel": "self"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
"rel": "data"
}
]
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItems.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItems.json
index 0d83c6416334..1862a002e696 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItems.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetItems.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]",
@@ -74,15 +75,15 @@
"numberReturned": 1,
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0&limit=1",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?api-version=1.0&limit=1",
"rel": "self"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit?api-version=1.0",
"rel": "data"
},
{
- "href": "https://atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?n=PMRG4ZLYOQRDUMJMEJYHEZLWEI5C2ML5&api-version=1.0&limit=1",
+ "href": "https://us.atlas.microsoft.com/wfs/dataset/4a25a249-8bd4-3f78-8cd8-eff11751d35b/collections/unit/items?n=PMRG4ZLYOQRDUMJMEJYHEZLWEI5C2ML5&api-version=1.0&limit=1",
"rel": "next"
}
]
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetLandingPage.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetLandingPage.json
index 028fa8cfe0aa..508aba14bca4 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetLandingPage.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/examples/GetLandingPage.json
@@ -1,5 +1,6 @@
{
"parameters": {
+ "geography": "us",
"api-version": "1.0",
"datasetid": "018fda98-e638-0edf-5ef7-28491ff3bed4",
"subscription-key": "[subscription-key]"
@@ -9,27 +10,27 @@
"body": {
"links": [
{
- "href": "https://atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4",
+ "href": "https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4",
"rel": "self",
"title": "Azure Maps WFS"
},
{
- "href": "https://atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/api",
+ "href": "https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/api",
"rel": "service",
"title": "The API definition"
},
{
- "href": "https://atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/conformance",
+ "href": "https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/conformance",
"rel": "conformance",
"title": "WFS 3.0 conformance classes implemented by this server"
},
{
- "href": "https://atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/version",
+ "href": "https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/version",
"rel": "data",
"title": "The version information"
},
{
- "href": "https://atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/collections",
+ "href": "https://us.atlas.microsoft.com/wfs/datasets/018fda98-e638-0edf-5ef7-28491ff3bed4/collections",
"rel": "data",
"title": "Metadata about the feature collections"
}
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/wfs.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/wfs.json
index 962c2490603e..c7dd3e056aba 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/wfs.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/1.0/wfs.json
@@ -5,7 +5,14 @@
"version": "1.0",
"description": "Azure Maps Web Feature REST APIs"
},
- "host": "atlas.microsoft.com",
+ "x-ms-parameterized-host": {
+ "hostTemplate": "{geography}.atlas.microsoft.com",
+ "parameters": [
+ {
+ "$ref": "#/parameters/GeographicResourceLocation"
+ }
+ ]
+ },
"schemes": [
"https"
],
@@ -87,6 +94,33 @@
}
},
"parameters": {
+ "GeographicResourceLocation": {
+ "name": "geography",
+ "description": "This parameter specifies where the Azure Maps Creator resource is located. Valid values are us and eu.",
+ "in": "path",
+ "required": true,
+ "type": "string",
+ "default": "us",
+ "enum": [
+ "us",
+ "eu"
+ ],
+ "x-ms-enum": {
+ "name": "GeographicResourceLocation",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "us",
+ "description": "Used to access an Azure Maps Creator resource in the United States"
+ },
+ {
+ "value": "eu",
+ "description": "Used to access an Azure Maps Creator resource in Europe"
+ }
+ ]
+ },
+ "x-ms-parameter-location": "client"
+ },
"ClientId": {
"name": "x-ms-client-id",
"description": "Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure Maps account and can be retrieved from Azure Maps management plane Account API. To use Azure AD security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.",
diff --git a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/2.0/wfs.json b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/2.0/wfs.json
index 924780df45b6..434a9e6bdbf2 100644
--- a/specification/maps/data-plane/Microsoft.Maps/WFS/preview/2.0/wfs.json
+++ b/specification/maps/data-plane/Microsoft.Maps/WFS/preview/2.0/wfs.json
@@ -389,7 +389,7 @@
},
"/wfs/datasets/{datasetid}/collections/{collectionId}/definition": {
"get": {
- "description": "**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\n The Web Feature Service (WFS) API is part of Creator. WFS API follows the [Open Geospatial Consortium API standard for Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html) to query [Datasets](https://docs.microsoft.com/en-us/rest/api/maps/dataset/createpreview). \nA dataset consists of multiple feature collections. A feature collection is a collection of features of a similar type, based on a common schema.\n \nThe Collection Definition API provides the detailed data model of a given collection.",
+ "description": "**Applies to:** see pricing [tiers](https://aka.ms/AzureMapsPricingTier).\n\nCreator makes it possible to develop applications based on your private indoor map data using Azure Maps API and SDK. [This](https://docs.microsoft.com/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator.\n\n [This](https://docs.microsoft.com/en-us/azure/azure-maps/creator-indoor-maps) article introduces concepts and tools that apply to Azure Maps Creator. WFS API follows the [Open Geospatial Consortium API standard for Features](http://docs.opengeospatial.org/is/17-069r3/17-069r3.html) to query [Datasets](https://docs.microsoft.com/en-us/rest/api/maps/dataset/createpreview). \nA dataset consists of multiple feature collections. A feature collection is a collection of features of a similar type, based on a common schema.\n \nThe Collection Definition API provides the detailed data model of a given collection.",
"operationId": "WFS_CollectionDefinition",
"x-publish": true,
"x-ms-examples": {