Merge pull request #268652 from stevemunk/iOS-deprecation-banner

denrea · web-flow · commit 87e43c1f7db9 · 2024-03-25T09:41:33.000-07:00
Added deprecation/retirement banner for iOS articles.
diff --git a/articles/azure-maps/add-bubble-layer-map-ios.md b/articles/azure-maps/add-bubble-layer-map-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 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 point radius.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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 `NSPredicate(format: "%@ == \"Point\"", NSExpression.geometryTypeAZMVariable)`. If you want to include MultiPoint features as well, use `NSCompoundPredicate`.  
 
diff --git a/articles/azure-maps/add-controls-map-ios.md b/articles/azure-maps/add-controls-map-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 This article shows you how to add UI controls to the map.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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/add-heat-map-layer-ios.md b/articles/azure-maps/add-heat-map-layer-ios.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Add a heat map layer in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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/add-image-layer-map-ios.md b/articles/azure-maps/add-image-layer-map-ios.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Add an image layer to a map in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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/add-line-layer-map-ios.md b/articles/azure-maps/add-line-layer-map-ios.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Add a line layer to the map in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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/add-polygon-extrusion-layer-map-ios.md b/articles/azure-maps/add-polygon-extrusion-layer-map-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 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 iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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/add-polygon-layer-map-ios.md b/articles/azure-maps/add-polygon-layer-map-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 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 iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the [Quickstart: Create an iOS app] document. Code blocks in this article can be inserted into the  `viewDidLoad` function of `ViewController`.
diff --git a/articles/azure-maps/add-symbol-layer-ios.md b/articles/azure-maps/add-symbol-layer-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 This article shows you how to render point data from a data source as a symbol layer on a map using the Azure Maps iOS SDK. Symbol layers render points as an image and text on the map.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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 `NSPredicate(format: "%@ == \"Point\"", NSExpression.geometryTypeAZMVariable)`. If you want to include MultiPoint features as well, use `NSCompoundPredicate`.
 
diff --git a/articles/azure-maps/add-tile-layer-map-ios.md b/articles/azure-maps/add-tile-layer-map-ios.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Add a tile layer to a map in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 This article shows you how to render a tile layer on a map using the Azure Maps iOS 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/clustering-point-data-ios-sdk.md b/articles/azure-maps/clustering-point-data-ios-sdk.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Clustering point data in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 When displaying 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.
 
 [Internet of Things Show - Clustering point data in Azure Maps]
diff --git a/articles/azure-maps/create-data-source-ios-sdk.md b/articles/azure-maps/create-data-source-ios-sdk.md
@@ -11,6 +11,12 @@ services: azure-maps
 
 # Create a data source in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 The Azure Maps iOS SDK stores data in data sources. Using data sources optimizes the data operations for querying and rendering. Currently there are two types of data sources:
 
 - **GeoJSON source**: Manages raw location data in GeoJSON format locally. Good for small to medium data sets (upwards of hundreds of thousands of shapes).
diff --git a/articles/azure-maps/data-driven-style-expressions-ios-sdk.md b/articles/azure-maps/data-driven-style-expressions-ios-sdk.md
@@ -12,6 +12,12 @@ services: azure-maps
 
 # Data-driven style expressions in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 Layers use predicates and expressions to determine what to display and how
 to format it. _Predicates_ are represented by the same `NSPredicate` class that
 filters results from Core Data or items in an `NSArray` in Objective-C.
diff --git a/articles/azure-maps/display-feature-information-ios-sdk.md b/articles/azure-maps/display-feature-information-ios-sdk.md
@@ -11,6 +11,12 @@ services: azure-maps
 
 # Display feature information in the iOS SDK (Preview)
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-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!"`.
 
 ```swift
diff --git a/articles/azure-maps/how-to-use-indoor-module-ios.md b/articles/azure-maps/how-to-use-indoor-module-ios.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 The Azure Maps iOS SDK allows you to render indoor maps created in Azure Maps Creator services.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Prerequisites
 
 1. Complete the steps in the [Quickstart: Create an iOS app]. Code blocks in this article can be inserted into the `viewDidLoad` function of `ViewController`.
diff --git a/articles/azure-maps/how-to-use-ios-map-control-library.md b/articles/azure-maps/how-to-use-ios-map-control-library.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 The Azure Maps iOS SDK is a vector map library for iOS. This article guides you through the processes of installing the Azure Maps iOS SDK and loading a map.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Prerequisites
 
 Be sure to complete the steps in the [Quickstart: Create an iOS app] article.
diff --git a/articles/azure-maps/interact-map-ios-sdk.md b/articles/azure-maps/interact-map-ios-sdk.md
@@ -14,6 +14,12 @@ services: azure-maps
 
 This article shows you how to use the maps events manager.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Interact with the map
 
 The map manages all events through its `events` property accepting delegates, which conform to the `AzureMapDelegate` protocol. The following table lists all supported map events represented as methods of the `AzureMapDelegate` protocol.
diff --git a/articles/azure-maps/ios-sdk-migration-guide.md b/articles/azure-maps/ios-sdk-migration-guide.md
@@ -13,6 +13,12 @@ ms.service: azure-maps
 
 Migrating from the Azure Maps iOS 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 iOS SDK to the Web SDK.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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.
+
 ## Prerequisites
 
 To use the Map Control in a web page, you must have one of the following prerequisites:
diff --git a/articles/azure-maps/migrate-from-bing-maps.md b/articles/azure-maps/migrate-from-bing-maps.md
@@ -44,8 +44,8 @@ The following table provides a high-level list of Bing Maps features and the rel
 | Bing Maps feature                     | Azure Maps support |
 |---------------------------------------|:------------------:|
 | Web SDK                               | ✓                  |
-| Android SDK                           | ✓                  |
-| iOS SDK                               | Planned            |
+| Android SDK                           | ✓<sup>1</sup>      |
+| iOS SDK                               | N/A<sup>2</sup>    |
 | UWP SDK                               | N/A                |
 | WPF SDK                               | N/A                |
 | REST Service APIs                     | ✓                  |
@@ -60,13 +60,16 @@ The following table provides a high-level list of Bing Maps features and the rel
 | Location Recognition                  | ✓                  |
 | Locations (forward/reverse geocoding) | ✓                  |
 | Optimized Itinerary Routes            | Planned            |
-| Snap to roads                         | <sup>1</sup>       |
+| Snap to roads                         | <sup>3</sup>       |
 | Spatial Data Services (SDS)           | Partial            |
 | Time Zone                             | ✓                  |
 | Traffic Incidents                     | ✓                  |
 | Configuration driven maps             | N/A                |
 
-<sup>1</sup> While there's no direct replacement for the Bing Maps *Snap to road* service, this functionality can be implemented using the Azure Maps [Route - Get Route Directions] REST API. For a complete code sample demonstrating the snap to road functionality, see the [Basic snap to road logic] sample that demonstrates how to snap individual points to the rendered roads on the map. Also see the [Snap points to logical route path] sample that shows how to snap points to the road network to form a logical path.
+
+<sup>1</sup> 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).
+<sup>2</sup> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+<sup>3</sup> While there's no direct replacement for the Bing Maps *Snap to road* service, this functionality can be implemented using the Azure Maps [Route - Get Route Directions] REST API. For a complete code sample demonstrating the snap to road functionality, see the [Basic snap to road logic] sample that demonstrates how to snap individual points to the rendered roads on the map. Also see the [Snap points to logical route path] sample that shows how to snap points to the road network to form a logical path.
 
 Bing Maps provides basic key-based authentication. Azure Maps provides both basic key-based authentication and highly secure, Microsoft Entra authentication.
 
diff --git a/articles/azure-maps/migrate-from-google-maps.md b/articles/azure-maps/migrate-from-google-maps.md
@@ -40,8 +40,8 @@ The table provides a high-level list of Azure Maps features, which correspond to
 | Google Maps feature         | Azure Maps support                     |
 |-----------------------------|:--------------------------------------:|
 | Web SDK                     | ✓                                      |
-| Android SDK                 | ✓                                      |
-| iOS SDK                     | Planned                                |
+| Android SDK                 | ✓<sup>1</sup>                          |
+| iOS SDK                     | N/A<sup>2</sup>                        |
 | REST Service APIs           | ✓                                      |
 | Directions (Routing)        | ✓                                      |
 | Distance Matrix             | ✓                                      |
@@ -60,6 +60,9 @@ 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> 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).
+<sup>2</sup> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 Google Maps provides basic key-based authentication. Azure Maps provides both basic key-based authentication and Microsoft Entra authentication. Microsoft Entra authentication provides more security features, compared to the basic key-based authentication.
 
 ## Licensing considerations
diff --git a/articles/azure-maps/quick-ios-app.md b/articles/azure-maps/quick-ios-app.md
@@ -20,6 +20,12 @@ This article shows you how to add the Azure Maps to an iOS app. It walks you thr
 * Reference the Azure Maps libraries from the project.
 * Add an Azure Maps control to the app.
 
+> [!NOTE]
+>
+> **Azure Maps iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Prerequisites
 
 If you don't have an Azure subscription, create a [free account] before you begin.
diff --git a/articles/azure-maps/set-map-style-ios-sdk.md b/articles/azure-maps/set-map-style-ios-sdk.md
@@ -13,6 +13,12 @@ services: azure-maps
 
 This article shows you two ways to set map styles using the Azure Maps iOS 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 iOS SDK retirement**
+>
+> The Azure Maps Native SDK for iOS 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 iOS SDK migration guide](ios-sdk-migration-guide.md).
+
 ## Prerequisites
 
 - Complete the [Create an iOS app] quickstart.
diff --git a/articles/azure-maps/show-traffic-data-map-ios-sdk.md b/articles/azure-maps/show-traffic-data-map-ios-sdk.md
