Merge pull request #107401 from stevemunk/Elevation-Services-Retirement

elevation services are being deprecated

Author: ShannonLeavitt

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

@@ -20,7 +20,6 @@ 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.
-* Elevation services with Digital Elevation Model
 * Geofencing service and mapping data storage, with location information hosted in Azure.
 * Location intelligence through geospatial analytics.
 
@@ -182,18 +181,6 @@ Maps Creator provides the following services:
 
 * [Wayfinding service] (preview). Use the [wayfinding API] to generate a path between two points within a facility. Use the [routeset API] to create the data that the wayfinding service needs to generate paths.
 
-### Elevation service
-
-The Azure Maps Elevation service is a web service that developers can use to retrieve elevation data from anywhere on the Earth’s surface.
-
-The Elevation service allows you to retrieve elevation data in two formats:
-
-* **GeoTIFF raster format**. Use the [Render V2-Get Map Tile API](/rest/api/maps/renderv2) to retrieve elevation data in tile format.
-
-* **GeoJSON format**. Use the [Elevation APIs](/rest/api/maps/elevation) to request sampled elevation data along paths, within a defined bounding box, or at specific coordinates.
-
-:::image type="content" source="./media/about-azure-maps/elevation.png" alt-text="Example of map with elevation data":::
-
 ## Programming model
 
 Azure Maps is built for mobility and can help you develop cross-platform applications. It uses a programming model that's language agnostic and supports JSON output through [REST APIs](/rest/api/maps/).

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

@@ -22,9 +22,9 @@ Below are the QPS usage limits for each Azure Maps service by Pricing Tier.
 | Creator - Alias, TilesetDetails | 10 | Not Available | Not Available |
 | Creator - Conversion, Dataset, Feature State, WFS | 50 | Not Available | Not Available |
 | Data service | 50 | 50 |  Not Available  |
-| Elevation service | 50 | 50 |  Not Available  |
+| Elevation service ([deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023)) | 50 | 50 |  Not Available  |
 | Geolocation service | 50 | 50 | 50 |
-| Render service - Contour tiles, Digital Elevation Model (DEM) tiles and Customer tiles | 50 | 50 | Not Available |
+| Render service - Contour tiles, Digital Elevation Model (DEM) tiles ([deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023)) and Customer tiles | 50 | 50 | Not Available |
 | Render service - Traffic tiles and Static maps | 50 | 50 | 50 |
 | Render service - Road tiles | 500 | 500 | 50 |
 | Render service - Satellite tiles | 250 | 250 | Not Available |

articles/azure-maps/how-to-dev-guide-java-sdk.md

@@ -12,7 +12,7 @@ services: azure-maps
 
 # Java REST SDK Developers Guide (preview)
 
-The Azure Maps Java SDK can be integrated with Java applications and libraries to build maps-related and location-aware applications. The Azure Maps Java SDK contains APIs for Search, Route, Render, Elevation, Geolocation, Traffic, Timezone, and Weather. These APIs support operations such as searching for an address, routing between different coordinates, obtaining the geo-location of a specific IP address etc.
+The Azure Maps Java SDK can be integrated with Java applications and libraries to build maps-related and location-aware applications. The Azure Maps Java SDK contains APIs for Search, Route, Render, Geolocation, Traffic, Timezone, and Weather. These APIs support operations such as searching for an address, routing between different coordinates, obtaining the geo-location of a specific IP address etc.
 
 > [!NOTE]
 > Azure Maps Java SDK is baselined on Java 8, with testing and forward support up until the latest Java long-term support release (currently Java 18). For the list of Java versions for download, see [Java Standard Versions].
@@ -109,7 +109,7 @@ New-Item demo.java
 | [Rendering][java rendering readme]| [azure-maps-rendering][java rendering package]|[rendering sample][java rendering sample] |
 | [Geolocation][java geolocation readme]|[azure-maps-geolocation][java geolocation package]|[geolocation sample][java geolocation sample] |
 | [Timezone][java timezone readme] | [azure-maps-timezone][java timezone package] | [timezone samples][java timezone sample] |
-| [Elevation][java elevation readme] | [azure-maps-elevation][java elevation package] | [elevation samples][java elevation sample] |
+| [Elevation][java elevation readme] ([deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023))| [azure-maps-elevation][java elevation package] | [elevation samples][java elevation sample] |
 
 ## Create and authenticate a MapsSearchClient
 

articles/azure-maps/how-to-request-elevation-data.md

@@ -1,8 +1,8 @@
 ---
 title: Request elevation data using the Azure Maps Elevation service
 description: Learn how to request elevation data using the Azure Maps Elevation service.
-author: eriklindeman
-ms.author: eriklind
+author: FarazGIS
+ms.author: fsiddiqui
 ms.date: 10/28/2021
 ms.topic: how-to
 ms.service: azure-maps
@@ -11,6 +11,9 @@ ms.custom: mvc
 
 # Request elevation data using the Azure Maps Elevation service
 
+> [!IMPORTANT]
+> The Azure Maps Elevation services and Render V2 DEM tiles have been retired and will no longer be available or supported after May 5, 2023. No other Azure Maps API, services or tilesets are affected. For more information, see [Elevation Services Retirement](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023).
+
 The Azure Maps [Elevation service](/rest/api/maps/elevation) provides APIs to query elevation data anywhere on the earth's surface. You can request sampled elevation data along paths, within a defined bounding box, or at specific coordinates. Also, you can use the [Render V2 - Get Map Tile API](/rest/api/maps/renderv2) to retrieve elevation data in tile format. The tiles are delivered in GeoTIFF raster format. This article describes how to use Azure Maps Elevation service and the Get Map Tile API to request elevation data. The elevation data can be requested in both GeoJSON and GeoTiff formats.
 
 ## Prerequisites

articles/azure-maps/migrate-from-bing-maps-web-services.md

@@ -38,12 +38,15 @@ The following table provides the Azure Maps service APIs that provide similar fu
 | Spatial Data Services (SDS)           | [Search] + [Route] + other Azure Services |
 | Time Zone                             | [Time Zone]                               |
 | Traffic Incidents                     | [Traffic Incident Details]                |
-| Elevation                             | [Elevation]
+| Elevations                            | <sup>1</sup>                              |
+
+<sup>1</sup> Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md).
 
 The following service APIs aren't currently available in Azure Maps:
 
 * Optimized Itinerary Routes - Planned. Azure Maps Route API does support traveling salesmen optimization for a single vehicle.
 * Imagery Metadata – Primarily used for getting tile URLs in Bing Maps. Azure Maps has a standalone service for directly accessing map tiles.
+* Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md)
 
 Azure Maps also has these REST web services:
 

articles/azure-maps/migrate-from-bing-maps.md

@@ -53,7 +53,7 @@ The following table provides a high-level list of Bing Maps features and the rel
 | Autosuggest                           | ✓                  |
 | Directions (including truck)          | ✓                  |
 | Distance Matrix                       | ✓                  |
-| Elevations                            | ✓                  |
+| Elevations                            | <sup>1</sup>       |
 | Imagery – Static Map                  | ✓                  |
 | Imagery Metadata                      | ✓                  |
 | Isochrones                            | ✓                  |
@@ -68,6 +68,8 @@ The following table provides a high-level list of Bing Maps features and the rel
 | Traffic Incidents                     | ✓                  |
 | Configuration driven maps             | N/A                |
 
+<sup>1</sup> Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md).
+
 Bing Maps provides basic key-based authentication. Azure Maps provides both basic key-based authentication and highly secure, Azure Active Directory authentication.
 
 ## Licensing considerations

articles/azure-maps/migrate-from-google-maps-web-app.md

@@ -73,7 +73,9 @@ The table lists key API features in the Google Maps V3 JavaScript SDK and the su
 | Geocoder service        | ✓                          |
 | Directions service      | ✓                          |
 | Distance Matrix service | ✓                          |
-| Elevation service       | ✓                          |
+| Elevation service       | <sup>1</sup>               |
+
+<sup>1</sup> Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md).
 
 ## Notable differences in the web SDKs
 

articles/azure-maps/migrate-from-google-maps-web-services.md

@@ -33,18 +33,20 @@ You will also learn:
 
 The table shows the Azure Maps service APIs, which have a similar functionality to the listed Google Maps service APIs.
 
-| Google Maps service API | Azure Maps service API                                                                      |
-|-------------------------|---------------------------------------------------------------------------------------------|
-| Directions              | [Route](/rest/api/maps/route)                                     |                         
-| Distance Matrix         | [Route Matrix](/rest/api/maps/route/postroutematrixpreview)       |                         
-| Geocoding               | [Search](/rest/api/maps/search)                                   |                         
-| Places Search           | [Search](/rest/api/maps/search)                                   |                         
-| Place Autocomplete      | [Search](/rest/api/maps/search)                                   |                         
-| Snap to Road            | See [Calculate routes and directions](#calculate-routes-and-directions) section.  |        
-| Speed Limits            | See [Reverse geocode a coordinate](#reverse-geocode-a-coordinate) section.         |         
-| Static Map              | [Render](/rest/api/maps/render/getmapimage)                       |                         
-| Time Zone               | [Time Zone](/rest/api/maps/timezone)                              |                         
-| Elevation               | [Elevation](/rest/api/maps/elevation)                   | 
+| Google Maps service API | Azure Maps service API                                                      |
+|-------------------------|-----------------------------------------------------------------------------|
+| Directions         | [Route](/rest/api/maps/route)                                                    |
+| Distance Matrix    | [Route Matrix](/rest/api/maps/route/postroutematrixpreview)                      |
+| Geocoding          | [Search](/rest/api/maps/search)                                                  |
+| Places Search      | [Search](/rest/api/maps/search)                                                  |
+| Place Autocomplete | [Search](/rest/api/maps/search)                                                  |
+| Snap to Road       | See [Calculate routes and directions](#calculate-routes-and-directions) section. |
+| Speed Limits       | See [Reverse geocode a coordinate](#reverse-geocode-a-coordinate) section.       |
+| Static Map         | [Render](/rest/api/maps/render/getmapimage)                                      |
+| Time Zone          | [Time Zone](/rest/api/maps/timezone)                                             |
+| Elevation          | [Elevation](/rest/api/maps/elevation)<sup>1</sup>                                |
+
+<sup>1</sup> Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md).
 
 The following service APIs aren't currently available in Azure Maps:
 

articles/azure-maps/migrate-from-google-maps.md

@@ -46,7 +46,7 @@ The table provides a high-level list of Azure Maps features, which correspond to
 | REST Service APIs           | ✓                                      |
 | Directions (Routing)        | ✓                                      |
 | Distance Matrix             | ✓                                      |
-| Elevation                   | ✓                                      |
+| Elevation                   | <sup>1</sup>                           |
 | Geocoding (Forward/Reverse) | ✓                                      |
 | Geolocation                 | ✓                                      |
 | Nearest Roads               | ✓                                      |
@@ -62,6 +62,8 @@ The table provides a high-level list of Azure Maps features, which correspond to
 | Maps Embedded API           | N/A                                    |
 | Map URLs                    | N/A                                    |
 
+<sup>1</sup> Azure Maps [Elevation services](/rest/api/maps/elevation) have been [deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023). For more information how to include this functionality in your Azure Maps, see [Create elevation data & services](elevation-data-services.md).
+
 Google Maps provides basic key-based authentication. Azure Maps provides both basic key-based authentication and Azure Active Directory authentication. Azure Active Directory authentication provides more security features, compared to the basic key-based authentication.
 
 ## Licensing considerations

articles/azure-maps/rest-sdk-developer-guide.md

@@ -66,7 +66,7 @@ Azure Maps Java SDK supports [Java 8][Java 8] or above.
 | [Rendering][java rendering readme]| [azure-maps-rendering][java rendering package]|[rendering sample][java rendering sample] |
 | [Geolocation][java geolocation readme]|[azure-maps-geolocation][java geolocation package]|[geolocation sample][java geolocation sample] |
 | [Timezone][java timezone readme] | [azure-maps-timezone][java timezone package] | [timezone samples][java timezone sample] |
-| [Elevation][java elevation readme] | [azure-maps-elevation][java elevation package] | [elevation samples][java elevation sample] |
+| [Elevation][java elevation readme] ([deprecated](https://azure.microsoft.com/updates/azure-maps-elevation-apis-and-render-v2-dem-tiles-will-be-retired-on-5-may-2023)) | [azure-maps-elevation][java elevation package] | [elevation samples][java elevation sample] |
 
 For more information, see the [Java SDK Developers Guide].