Merge pull request #286999 from stevemunk/retirement-banner-data-registry-spatial-creator

Retirement banners for Azure Maps Data registry, Spatial and Creator

Author: v-shils

.openpublishing.redirection.json

@@ -480,6 +480,11 @@
       "redirect_url": "/azure/azure-health-insights/overview",
       "redirect_document_id": false
     },
+    {
+      "source_path_from_root": "/articles/azure-maps/tutorial-iot-hub-maps.md",
+      "redirect_url": "/azure/azure-maps",
+      "redirect_document_id": true
+    },
     {
       "source_path_from_root": "/articles/azure-maps/about-creator.md",
       "redirect_url": "/azure/azure-maps/creator-indoor-maps",

articles/azure-maps/about-azure-maps.md

@@ -19,7 +19,7 @@ Azure Maps is a collection of geospatial services and SDKs that use fresh mappin
 * Various routing options; such as point-to-point, multipoint, multipoint optimization, isochrone, electric vehicle, commercial vehicle, traffic influenced, and matrix routing.
 * Traffic flow view and incidents view, for applications that require real-time traffic information.
 * Time zone and Geolocation services.
-* Geofencing service and mapping data storage, with location information hosted in Azure.
+* Geofencing service with location information hosted in Azure.
 * Location intelligence through geospatial analytics.
 
 Additionally, Azure Maps services are available through the Web SDK. These tools help developers quickly develop and scale solutions that integrate location information into Azure solutions.
@@ -56,10 +56,6 @@ Use the Azure Maps Android SDK to create mobile mapping applications.
 
 Azure Maps consists of the following services that can provide geographic context to your Azure applications.
 
-### Data registry service
-
-Data is imperative for maps. Use the Data registry service to access geospatial data, used with spatial operations or image composition, previously uploaded to your [Azure Storage].  By bringing customer data closer to the Azure Maps service, you reduce latency and increase productivity. For more information, see [Data registry] in the Azure Maps REST API documentation.
-
 ### Geolocation service
 
 Use the Geolocation service to retrieve the two-letter country/region code for an IP address. This service can help you enhance user experience by providing customized application content based on geographic location.
@@ -107,12 +103,6 @@ The Search service also provides advanced features such as:
 
 For more information, see [Search] in the Azure Maps REST API documentation.
 
-### Spatial service
-
-The Spatial service quickly analyzes location information to help inform customers of ongoing events happening in time and space. It enables near real-time analysis and predictive modeling of events.
-
-The service enables customers to enhance their location intelligence with a library of common geospatial mathematical calculations. Common calculations include closest point, great circle distance, and buffers. For more information about the Spatial service and its various features, see [Spatial] in the Azure Maps REST API documentation.
-
 ### Timezone service
 
 The Time zone service enables you to query current, historical, and future time zone information. You can use either latitude and longitude pairs or an [IANA ID] as an input. The Time zone service also allows for:
@@ -217,15 +207,11 @@ Stay up to date on Azure Maps:
 [Azure Maps blog]
 
 <!---------   learn.microsoft.com links     --------------->
-[Azure Storage]: ../storage/common/storage-introduction.md
 [Get started with Azure Maps Power BI visual]: power-bi-visual-get-started.md
 [How to use the Get Map Attribution API]: how-to-show-attribution.md
 [Quickstart: Create a web app]: quick-demo-map-app.md
-[v1]: /rest/api/maps/data?view=rest-maps-1.0&preserve-view=true
-[v2]: /rest/api/maps/data
-[How to create data registry]: how-to-create-data-registries.md
+
 <!---------   REST API Links     --------------->
-[Data registry]: /rest/api/maps/data-registry
 [Geolocation]: /rest/api/maps/geolocation
 [Get Map Tile]: /rest/api/maps/render/get-map-tile
 [Get Weather along route API]: /rest/api/maps/weather/getweatheralongroute
@@ -235,7 +221,6 @@ Stay up to date on Azure Maps:
 [REST APIs]: /rest/api/maps/
 [Route]: /rest/api/maps/route
 [Search]: /rest/api/maps/search?view=rest-maps-1.0&preserve-view=true
-[Spatial]: /rest/api/maps/spatial
 [TilesetID]: /rest/api/maps/render/get-map-tile#tilesetid
 [Timezone]: /rest/api/maps/timezone
 [Traffic]: /rest/api/maps/traffic

articles/azure-maps/azure-maps-authentication.md

@@ -27,7 +27,7 @@ Primary and secondary keys are generated after the Azure Maps account is created
 Example using the _subscription key_ as a parameter in your URL:
 
 ```http
-https://atlas.microsoft.com/mapData/upload?api-version=1.0&dataFormat=zip&subscription-key={Your-Azure-Maps-Subscription-key}
+https://atlas.microsoft.com/map/tile?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=15&x=5236&y=12665&tileSize=256
 ```
 
 > [!IMPORTANT]
@@ -125,12 +125,13 @@ The following role definition types exist to support application scenarios.
 
 Some Azure Maps services may require elevated privileges to perform write or delete actions on Azure Maps REST APIs. Azure Maps Data Contributor role is required for services, which provide write or delete actions. The following table describes what services Azure Maps Data Contributor is applicable when using write or delete actions. When only read actions are required, the Azure Maps Data Reader role can be used in place of the Azure Maps Data Contributor role.
 
-| Azure Maps service         | Azure Maps Role Definition  |
-| :--------------------------| :-------------------------- |
-| [Data]                     | Azure Maps Data Contributor |
-| [Creator]                  | Azure Maps Data Contributor |
-| [Spatial]                  | Azure Maps Data Contributor |
-| Batch [Search] and [Route] | Azure Maps Data Contributor |
+| Azure Maps service                 | Azure Maps Role Definition  |
+| :----------------------------------| :-------------------------- |
+| [Creator] (Deprecated<sup>1</sup>) | Azure Maps Data Contributor |
+| [Spatial] (Deprecated<sup>1</sup>) | Azure Maps Data Contributor |
+| Batch [Search] and [Route]         | Azure Maps Data Contributor |
+
+<sup>1</sup> Azure Maps Creator, and the Data registry and Spatial services are now deprecated and will be retired on 9/30/25.
 
 For information about viewing your Azure RBAC settings, see [How to configure Azure RBAC for Azure Maps].
 
@@ -272,7 +273,7 @@ SAS token parameters:
 | :--------------- | :----------------------------------------- | :---------------------------------------------------- |
 | signingKey       | `primaryKey`                               | Required, the string enum value for the signingKey either `primaryKey`, `secondaryKey` or managed identity is used to create the signature of the SAS. |
 | principalId      | `<GUID>`                                   | Required, the principalId is the Object (principal) ID of the user-assigned managed identity attached to the map account. |
-| regions          | `[ "eastus", "westus2", "westcentralus" ]` | Optional, the default value is `null`. The regions control which regions the SAS token can be used in the Azure Maps REST [data-plane] API. Omitting regions parameter allows the SAS token to be used without any constraints. When used in combination with an Azure Maps data-plane geographic endpoint like `us.atlas.microsoft.com` and `eu.atlas.microsoft.com` allows the application to control usage with-in the specified geography. This allows prevention of usage in other geographies. |
+| regions          | `[ "eastus", "westus2", "westcentralus" ]` | Optional, the default value is `null`. The regions control which regions the SAS token can be used in the Azure Maps REST [data-plane] API. Omitting regions parameter allows the SAS token to be used without any constraints. When used in combination with an Azure Maps data-plane geographic endpoint like `us.atlas.microsoft.com` and `eu.atlas.microsoft.com` allows the application to control usage within the specified geography. This allows prevention of usage in other geographies. |
 | maxRatePerSecond | 500                                        | Required, the specified approximate maximum request per second which the SAS token is granted. Once the limit is reached, more throughput is rate limited with HTTP status code `429 (TooManyRequests)`. |
 | start            | `2021-05-24T10:42:03.1567373Z`             | Required, a UTC date that specifies the date and time the token becomes active. |
 | expiry           | `2021-05-24T11:42:03.1567373Z`             | Required, a UTC date that specifies the date and time the token expires. The duration between start and expiry can't be more than 24 hours. |

articles/azure-maps/azure-maps-qps-rate-limits.md

@@ -24,9 +24,9 @@ The following list shows the QPS usage limits for each Azure Maps service by Pri
 | Azure Maps service | QPS Limit: Gen 2 Pricing Tier | QPS Limit: Gen 1 S1 Pricing Tier | QPS Limit: Gen 1 S0 Pricing Tier |
 |  ----------------- |  :--------------------------: | :------------------------------: | :------------------------: |
 | Copyright service | 10 | 10 | 10 |
-| Creator - Alias | 10 | Not Available | Not Available |
-| Creator - Conversion, Dataset, Feature State, Features, Map Configuration, Style, Routeset, TilesetDetails, Wayfinding | 50 | Not Available | Not Available |
-| Data registry service | 50 | 50 |  Not Available  |
+| Creator - Alias (Deprecated<sup>1</sup>) | 10 | Not Available | Not Available |
+| Creator - Conversion, Dataset, Feature State, Features, Map Configuration, Style, Routeset, TilesetDetails, Wayfinding (Deprecated<sup>1</sup>) | 50 | Not Available | Not Available |
+| Data registry service (Deprecated<sup>1</sup>) | 50 | 50 |  Not Available  |
 | Geolocation service | 50 | 50 | 50 |
 | Render service - Road tiles | 500 | 500 | 50 |
 | Render service - Satellite tiles | 250 | 250 | Not Available |
@@ -38,11 +38,13 @@ The following list shows the QPS usage limits for each Azure Maps service by Pri
 | Search service - Batch | 10 | 10 | Not Available |
 | Search service - Non-Batch | 500 | 500 | 50 |
 | Search service - Non-Batch Reverse | 250 | 250 | 50 |
-| Spatial service | 50 | 50 |  Not Available  |
+| Spatial service (Deprecated<sup>1</sup>) | 50 | 50 |  Not Available  |
 | Timezone service | 50 | 50 | 50 |
 | Traffic service | 50 | 50 | 50 |
 | Weather service | 50 | 50 | 50 |
 
+<sup>1</sup> Azure Maps Creator, and the Data registry and Spatial services are now deprecated and will be retired on 9/30/25.
+
 When QPS limits are reached, an HTTP 429 error is returned. If you're using the Gen 2 or Gen 1 S1 pricing tiers, you can create an Azure Maps *Technical* Support Request in the [Azure portal] to increase a specific QPS limit if needed. QPS limits for the Gen 1 S0 pricing tier can't be increased.
 
 [Azure portal]: https://portal.azure.com/

articles/azure-maps/creator-geographic-scope.md

@@ -12,6 +12,12 @@ ms.custom: mvc, references_regions
 
 # Creator service geographic scope
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 Azure Maps Creator is a geographically scoped service. Creator offers a resource provider API that, given an Azure region, creates an instance of Creator data deployed at the geographical level. The mapping from an Azure region to geography happens behind the scenes as described in the following table. For more information on Azure regions and geographies, see [Azure geographies].
 
 ## Data locations

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

@@ -4,7 +4,7 @@ titleSuffix: Azure Maps Creator
 description: This article introduces concepts that apply to Azure Maps Creator services
 author: faterceros
 ms.author: aterceros
-ms.date: 04/01/2022
+ms.date: 09/16/2024
 ms.topic: conceptual
 ms.service: azure-maps
 ms.subservice: creator
@@ -13,6 +13,12 @@ ms.subservice: creator
 
 # Creator for indoor maps
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 This article introduces concepts and tools that apply to Azure Maps Creator. We recommend that you read this article before you begin to use the Azure Maps Creator API and SDK.
 
 You can use Creator to develop applications with map features that are based on indoor map data. This article describes the process of uploading, converting, creating, and using your map data. Typically, the workflow is completed by two different personas with distinct areas of expertise and responsibility:

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

@@ -3,7 +3,7 @@ title: Azure Maps long-running operation API V2
 description: Learn about long-running asynchronous V2 background processing in Azure Maps
 author: faterceros
 ms.author: aterceros
-ms.date: 05/18/2021
+ms.date: 09/16/2024
 ms.topic: conceptual
 ms.service: azure-maps
 ms.subservice: creator
@@ -12,6 +12,12 @@ ms.custom: mvc
 
 # Creator Long-Running Operation API V2
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 Some APIs in Azure Maps use an [Asynchronous Request-Reply pattern]. This pattern allows Azure Maps to provide highly available and responsive services. This article explains Azure Map's specific implementation of long-running asynchronous background processing.
 
 ## Submit a request

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

@@ -12,6 +12,12 @@ ms.custom: mvc
 
 # Creator Long-Running Operation API
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 Some APIs in Azure Maps use an [Asynchronous Request-Reply pattern]. This pattern allows Azure Maps to provide highly available and responsive services. This article explains Azure Map's specific implementation of long-running asynchronous background processing.
 
 ## Submitting a request

articles/azure-maps/creator-onboarding-tool.md

@@ -4,14 +4,20 @@ titleSuffix: Azure Maps Creator
 description: This article describes how to create an indoor map using the onboarding tool
 author: faterceros
 ms.author: aterceros
-ms.date: 08/15/2023
+ms.date: 09/16/2024
 ms.topic: how-to
 ms.service: azure-maps
 ms.subservice: creator
 ---
 
 # Create indoor map with the onboarding tool
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 This article demonstrates how to create an indoor map using the Azure Maps Creator onboarding tool.
 
 ## Prerequisites

articles/azure-maps/creator-qgis-plugin.md

@@ -12,6 +12,12 @@ ms.subservice: creator
 
 # Work with datasets using the QGIS plugin
 
+> [!NOTE]
+>
+> **Azure Maps Creator retirement**
+>
+> The Azure Maps Creator indoor map service is now deprecated and will be retired on 9/30/25. For more information, see [End of Life Announcement of Azure Maps Creator](https://aka.ms/AzureMapsCreatorDeprecation).
+
 [QGIS] is an open-source [geographic information system (GIS)] application that supports viewing, editing, and analysis of geospatial data.
 
 The [Azure Maps QGIS plugin] is used to view and edit [datasets] in [QGIS]. It enables you to navigate floors using a custom floor-picker and perform CRUD operations for multiple features simultaneously. All QGIS functionalities, such as copying features, rotating, resizing, flipping, can be used to for advanced editing. The plugin also supports error handling for data editing. Logs created by the plugin are useful to understand the APIs and debug errors.