Added deprecation/retirement banner for Android SDK articles.

stevemunk · stevemunk · commit 33935d25cd25 · 2024-03-11T13:00:31.000-07:00
diff --git a/articles/azure-maps/android-map-add-line-layer.md b/articles/azure-maps/android-map-add-line-layer.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Add a line layer to the map (Android SDK)
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 A line layer can be used to render `LineString` and `MultiLineString` features as paths or routes on the map. A line layer can also be used to render the outline of `Polygon` and `MultiPolygon` features. A data source is connected to a line layer to provide it with data to render.
 
 > [!TIP]
diff --git a/articles/azure-maps/android-map-events.md b/articles/azure-maps/android-map-events.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to use the maps events manager.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Interact with the map
 
 The map manages all events through its `events` property. The following table lists the supported map events.
diff --git a/articles/azure-maps/android-sdk-migration-guide.md b/articles/azure-maps/android-sdk-migration-guide.md
@@ -13,6 +13,12 @@ ms.service: azure-maps
 
 Migrating from the Azure Maps Android SDK to the Web SDK in a WebView involves transitioning your existing map view from a native implementation to a web-based map using the Azure Maps Web SDK. This guide shows you how to migrate your code and features from the Android SDK to the Web SDK.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 To use the Map Control in a web page, you must have one of the following prerequisites:
diff --git a/articles/azure-maps/clustering-point-data-android-sdk.md b/articles/azure-maps/clustering-point-data-android-sdk.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 When visualizing many data points on the map, data points may overlap over each other. The overlap may cause the map may become unreadable and difficult to use. Clustering point data is the process of combining point data that are near each other and representing them on the map as a single clustered data point. As the user zooms into the map, the clusters break apart into their individual data points. When you work with large number of data points, use the clustering processes to improve your user experience.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 </br>
 
 >[!VIDEO https://learn.microsoft.com/Shows/Internet-of-Things-Show/Clustering-point-data-in-Azure-Maps/player?format=ny]
diff --git a/articles/azure-maps/create-data-source-android-sdk.md b/articles/azure-maps/create-data-source-android-sdk.md
@@ -18,6 +18,12 @@ The Azure Maps Android SDK stores data in data sources. Using data sources optim
 - **GeoJSON source**: Manages raw location data in GeoJSON format locally. Good for small to medium data sets (upwards of hundreds of thousands of shapes).
 - **Vector tile source**: Loads data formatted as vector tiles for the current map view, based on the maps tiling system. Ideal for large to massive data sets (millions or billions of shapes).
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## GeoJSON data source
 
 Azure Maps uses GeoJSON as one of its primary data models. GeoJSON is an open geospatial standard way for representing geospatial data in JSON format. GeoJSON classes available in the Azure Maps Android SDK to easy create, and serialize GeoJSON data. Load and store GeoJSON data in the `DataSource` class and render it using layers. The following code shows how GeoJSON objects can be created in Azure Maps.
diff --git a/articles/azure-maps/data-driven-style-expressions-android-sdk.md b/articles/azure-maps/data-driven-style-expressions-android-sdk.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Data-driven style expressions (Android SDK)
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 Expressions enable you to apply business logic to styling options that observe the properties defined in each shape in a data source. Expressions can filter data in a data source or a layer. Expressions may consist of conditional logic, like if-statements. And, they can be used to manipulate data using: string operators, logical operators, and mathematical operators.
 
 Data-driven styles reduce the amount of code needed to implement business logic around styling. When used with layers, expressions are evaluated at render time on a separate thread. This functionality provides increased performance compared to evaluating business logic on the UI thread.
diff --git a/articles/azure-maps/display-feature-information-android.md b/articles/azure-maps/display-feature-information-android.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Display feature information
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 Spatial data is often represented using points, lines, and polygons. This data often has metadata information associated with it. For example, a point may represent the location of a restaurant and metadata about that restaurant may be its name, address, and type of food it serves. This metadata can be added as properties of a GeoJSON `Feature`. The following code creates a simple point feature with a `title` property that has a value of "Hello World!"
 
 ::: zone pivot="programming-language-java-android"
diff --git a/articles/azure-maps/how-to-add-shapes-to-android-map.md b/articles/azure-maps/how-to-add-shapes-to-android-map.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to render the areas of `Polygon` and `MultiPolygon` feature geometries on the map using a polygon layer.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the [Quickstart: Create an Android app] document. Code blocks in this article can be inserted into the maps `onReady` event handler.
diff --git a/articles/azure-maps/how-to-add-symbol-to-android-map.md b/articles/azure-maps/how-to-add-symbol-to-android-map.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to render point data from a data source as a symbol layer on a map using the Azure Maps Android SDK. Symbol layers render points as an image and text on the map.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 > [!TIP]
 > Symbol layers by default will render the coordinates of all geometries in a data source. To limit the layer so that it only renders point geometry features, set the `filter` option of the layer to `eq(geometryType(), "Point")`. If you want to include MultiPoint features as well, set the `filter` option of the layer to `any(eq(geometryType(), "Point"), eq(geometryType(), "MultiPoint"))`.
 
diff --git a/articles/azure-maps/how-to-add-tile-layer-android-map.md b/articles/azure-maps/how-to-add-tile-layer-android-map.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Add a tile layer to a map (Android SDK)
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 This article shows you how to render a tile layer on a map using the Azure Maps Android SDK. Tile layers allow you to superimpose images on top of Azure Maps base map tiles. More information on Azure Maps tiling system can be found in the [Zoom levels and tile grid] documentation.
 
 A Tile layer loads in tiles from a server. These images can be prerendered and stored like any other image on a server, using a naming convention that the tile layer understands. Or, these images can be rendered with a dynamic service that generates the images near real time. There are three different tile service naming conventions supported by Azure Maps TileLayer class:
diff --git a/articles/azure-maps/how-to-show-traffic-android.md b/articles/azure-maps/how-to-show-traffic-android.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 Flow data and incidents data are the two types of traffic data that can be displayed on the map. This guide shows you how to display both types of traffic data. Incidents data consists of point and line-based data for things such as constructions, road closures, and accidents. Flow data shows metrics about the flow of traffic on the road.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the [Quickstart: Create an Android app](quick-android-map.md) document. Code blocks in this article can be inserted into the maps `onReady` event handler.
diff --git a/articles/azure-maps/how-to-use-android-map-control-library.md b/articles/azure-maps/how-to-use-android-map-control-library.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 The Azure Maps Android SDK is a vector map library for Android. This article guides you through the processes of installing the Azure Maps Android SDK and loading a map.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the [Quickstart: Create an Android app](quick-android-map.md) article.
diff --git a/articles/azure-maps/map-add-bubble-layer-android.md b/articles/azure-maps/map-add-bubble-layer-android.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to render point data from a data source as a bubble layer on a map. Bubble layers render points as circles on the map with a fixed pixel radius.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 > [!TIP]
 > Bubble layers by default will render the coordinates of all geometries in a data source. To limit the layer so that it only renders point geometry features, set the `filter` option of the layer to `eq(geometryType(), "Point")`. If you want to include MultiPoint features as well, set the `filter` option of the layer to `any(eq(geometryType(), "Point"), eq(geometryType(), "MultiPoint"))`.
 
diff --git a/articles/azure-maps/map-add-controls-android.md b/articles/azure-maps/map-add-controls-android.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to add UI controls to the map.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Add zoom control
 
 A zoom control adds buttons for zooming the map in and out. The following code sample creates an instance of the `ZoomControl` class and adds it to a map.
diff --git a/articles/azure-maps/map-add-heat-map-layer-android.md b/articles/azure-maps/map-add-heat-map-layer-android.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Add a heat map layer (Android SDK)
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 Heat maps, also known as point density maps, are a type of data visualization. They're used to represent the density of data using a range of colors and show the data "hot spots" on a map. Heat maps are a great way to render datasets with large number of points.
 
 Rendering tens of thousands of points as symbols can cover most of the map area. This case likely results in many symbols overlapping. Making it difficult to gain a better understanding of the data. However, visualizing this same dataset as a heat map makes it easy to see the density and the relative density of each data point.
diff --git a/articles/azure-maps/map-add-image-layer-android.md b/articles/azure-maps/map-add-image-layer-android.md
@@ -13,6 +13,12 @@ zone_pivot_groups: azure-maps-android
 
 # Add an image layer to a map (Android SDK)
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 This article shows you how to overlay an image to a fixed set of coordinates. Here are a few examples of different images types that can be overlaid on maps:
 
 * Images captured from drones
diff --git a/articles/azure-maps/map-extruded-polygon-android.md b/articles/azure-maps/map-extruded-polygon-android.md
@@ -15,6 +15,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you how to use the polygon extrusion layer to render areas of `Polygon` and `MultiPolygon` feature geometries as extruded shapes.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Use a polygon extrusion layer
 
 Connect the polygon extrusion layer to a data source. Then, loaded it on the map. The polygon extrusion layer renders the areas of a `Polygon` and `MultiPolygon` features as extruded shapes. The `height` and `base` properties of the polygon extrusion layer define the base distance from the ground and height of the extruded shape in **meters**. The following code shows how to create a polygon, add it to a data source, and render it using the Polygon extrusion layer class.
diff --git a/articles/azure-maps/migrate-from-google-maps-android-app.md b/articles/azure-maps/migrate-from-google-maps-android-app.md
@@ -16,6 +16,12 @@ zone_pivot_groups: azure-maps-android
 
 The Azure Maps Android SDK has an API interface that is similar to the Web SDK. If you've developed with one of these SDKs, many of the same concepts, best practices, and architectures apply. This tutorial demonstrates how to:
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 > [!div class="checklist"]
 >
 > * Load a map
diff --git a/articles/azure-maps/quick-android-map.md b/articles/azure-maps/quick-android-map.md
@@ -22,6 +22,12 @@ This article shows you how to add the Azure Maps to an Android app. It walks you
 * Reference the Azure Maps libraries from the project.
 * Add an Azure Maps control to the app.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 1. A subscription to [Microsoft Azure]. If you don't have an Azure subscription, [create a free account] before you begin.
diff --git a/articles/azure-maps/set-android-map-styles.md b/articles/azure-maps/set-android-map-styles.md
@@ -16,6 +16,12 @@ zone_pivot_groups: azure-maps-android
 
 This article shows you two ways to set map styles using the Azure Maps Android SDK. Azure Maps has six different maps styles to choose from. For more information about supported map styles, see [supported map styles in Azure Maps].
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the Quickstart: [Create an Android app].
diff --git a/articles/azure-maps/tutorial-load-geojson-file-android.md b/articles/azure-maps/tutorial-load-geojson-file-android.md
@@ -23,6 +23,12 @@ This tutorial guides you through the process of importing a GeoJSON file of loca
 > * Display the data on the map.
 > * Interact with the data on the maps to view its details.
 
+> [!NOTE]
+>
+> **Azure Maps Android SDK retirement**
+>
+> The Azure Maps Native SDK for Android is now deprecated and will be retired on 3/31/25. To avoid service disruptions, migrate to the Azure Maps Web SDK by 3/31/25. For more information, see [The Azure Maps Android SDK migration guide](android-sdk-migration-guide.md).
+
 ## Prerequisites
 
 1. Complete the [Quickstart: Create an Android app]. This tutorial extends the code used in that quickstart.
