Merge pull request #714 from telerik/dkrastev/m-Map-AddNoteBingDeprecation

nade7o · web-flow · commit 01edc4bfaf43 · 2025-04-30T16:33:38.000+03:00
Map: Add note for deprecation of Bing and link to AzureMap SDK
diff --git a/controls/map/getting-started.md b/controls/map/getting-started.md
@@ -34,6 +34,8 @@ The Telerik UI for WinForms assemblies can be install by using one of the availa
 
 ## Defining the RadMap
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 Follow the steps:
 
 1\. Create a new __Windows Application__ project.
diff --git a/controls/map/how-to/adding-pins-and-drawing-regions.md b/controls/map/how-to/adding-pins-and-drawing-regions.md
@@ -10,6 +10,8 @@ position: 1
 
 # Drawing Markers and Regions
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 A common requirement for applications utilizing a map control is to allow the end users add pins on the map and draw regions on it. **RadMap** exposes the necessary API and it can be easily extended with such functionalities. The example in this how-to article will handle a scenario in which pins are being added on the map after double clicking on it. As soon as the count of the markers increases to three so that they form a figure a region will be created. 
 
 >caption Figure 1: RadMap Pins and Regions 
diff --git a/controls/map/overview.md b/controls/map/overview.md
@@ -21,6 +21,8 @@ __RadMap__ can visualize tile data from the [Bing Maps](https://www.bingmapsport
 
 ## Key Features
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 * Pan and Zoom
 * Bing Maps and OpenStreetMaps imagery services
 * Bing Maps Search, Route and Elevation services
diff --git a/controls/map/providers/azuremapprovider.md b/controls/map/providers/azuremapprovider.md
@@ -0,0 +1,14 @@
+---
+title: Azure Map Custom Provider
+page_title: Azure Map Custom Provider - RadMap
+description: RadMap can visualize tile data from the Azure API services as well as from the local file system.
+slug: winforms/map/providers/azure
+tags: map, providers,azure
+published: True
+position: 1 
+---
+
+# Azure Map Custom Provider
+
+As of June 30, 2025, [Bing Maps](https://www.bingmapsportal.com/) will be deprecated. To support this transition, we’ve provided an [SDK example in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider) that demonstrates how to create a custom provider leveraging the Azure Maps API. Developers intending to use this approach will need to obtain a valid Azure Maps subscription key.
+
diff --git a/controls/map/providers/bingmaps/bingrestmapprovider.md b/controls/map/providers/bingmaps/bingrestmapprovider.md
@@ -10,6 +10,8 @@ position: 0
 
 # BingRestMapProvider
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 __RadMap__ can visualize tile data from the [Bing Maps](https://www.bingmapsportal.com/) REST service. You can enable tile caching to a local folder by setting a new __LocalFileCacheProvider__ to the BingRestMapProvider.__CacheProvider__ property.
 
 >caption Figure 1: BingRestMapProvider 
diff --git a/controls/map/providers/bingmaps/elevation/bounds.md b/controls/map/providers/bingmaps/elevation/bounds.md
@@ -10,6 +10,8 @@ position: 3
 
 # Bounds ElevationType
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 ElevationType.*Bounds* __ElevationRequest__ gets elevations at equally-spaced locations within an area on the Earth defined as a bounding box.
 
 >caption Figure 1: Bounds ElevationRequest 
diff --git a/controls/map/providers/bingmaps/elevation/elevation.md b/controls/map/providers/bingmaps/elevation/elevation.md
@@ -10,6 +10,8 @@ position: 0
 
 # Elevation
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 The Bing Elevation service will enable you to query for elevation information for a set of points, polyline or a region on the Earth described by latitude and longitude pairs.
 
 To use the Elevation API, it is necessary to create an __ElevationRequest__.
diff --git a/controls/map/providers/bingmaps/elevation/list.md b/controls/map/providers/bingmaps/elevation/list.md
@@ -10,6 +10,8 @@ position: 1
 
 # List ElevationType
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 ElevationType.*List* __ElevationRequest__ gets elevations for latitude and longitude coordinates. Elevations are returned for each set of coordinates.
 
 >caption Figure 1: List ElevationRequest 
diff --git a/controls/map/providers/bingmaps/elevation/polyline.md b/controls/map/providers/bingmaps/elevation/polyline.md
@@ -10,6 +10,8 @@ position: 2
 
 # Polyline ElevationType
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 ElevationType.*Polyline* __ElevationRequest__ gets elevations at equally-spaced locations along a polyline path. A polyline path is computed from the coordinates, and then elevation values at both endpoints and equally-spaced locations along the polyline are returned. The samples parameter specifies the number of elevations to return.
 
 >caption Figure 1: Polyline ElevationRequest 
diff --git a/controls/map/providers/bingmaps/elevation/sealevel.md b/controls/map/providers/bingmaps/elevation/sealevel.md
@@ -9,6 +9,8 @@ position: 4
 ---
 # SeaLevel ElevationType
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 ElevationType.*SeaLevel* __ElevationRequest__  gets the offset of the geoid sea level Earth model from the ellipsoid Earth model at a set of latitude and longitude coordinates.
 
 >caption Figure 1: SeaLevel ElevationRequest 
diff --git a/controls/map/providers/bingmaps/imagery-sets.md b/controls/map/providers/bingmaps/imagery-sets.md
@@ -10,6 +10,8 @@ position: 1
 
 # Imagery sets
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 The Bind Maps Rest Provider imagery service supports different types of visualization. The possible imagery sets which can be used are:
 
 * [__Aerial with Labels__](#aerial-with-labels)
diff --git a/controls/map/providers/bingmaps/route.md b/controls/map/providers/bingmaps/route.md
@@ -10,6 +10,8 @@ position: 3
 
 # Route
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 __RadMap__ provides a unified route search architecture which uses functionality of the different routing services. This allows you to calculate a route between different locations on the map. The routing is achieved by an __IMapRouteProvider__. The __BingRestMapProvider__ implements the __IMapRouteProvider__ interface.
 
 >caption Figure 1: Bing routing
diff --git a/controls/map/providers/bingmaps/search.md b/controls/map/providers/bingmaps/search.md
@@ -10,6 +10,8 @@ position: 2
 
 # Search
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 __RadMap__ allows you to implement search functionality, that will let the user search for a specific location on the map. The search is performed through an __IMapSearchProvider__, which communicates with the respective map provider's services. __BingRestMapProvider__ implements the __IMapSearchProvider__ interface.
 
 >caption Figure 1: Bing search
diff --git a/controls/map/providers/bingmaps/tiles.md b/controls/map/providers/bingmaps/tiles.md
@@ -10,6 +10,8 @@ position: 1
 
 # Tiles
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 [Bing Maps](https://www.bingmapsportal.com/) provide a world map that users can easily pan and zoom. In order to achieve smooth users interaction, the map is pre-rendered at many detailed levels where each level is cut into tiles of 256 x 256 pixels each. Each tile is given XY coordinates ranging from (0, 0) in the upper left to (2<sup>level</sup>–1, 2<sup>level</sup>–1) in the lower right. For example, at level 3 the tile coordinates range from (0, 0) to (7, 7) as follows:
 
 >caption Figure 1: Tile XY coordinates at level 3
diff --git a/controls/map/providers/bingmaps/truck-route.md b/controls/map/providers/bingmaps/truck-route.md
@@ -10,6 +10,8 @@ position: 3
 
 # Truck Route
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 As of **R1 2020** **RadMap** supports the [Bing Maps Truck Routing API](https://docs.microsoft.com/en-us/bingmaps/rest-services/routes/calculate-a-truck-route). It provides travel routes which take truck attributes such as size, weight and type of cargo. This is important as not all trucks can travel the same routes as other vehicles.
  
 The whole information that is necessary for calculating the route, is stored in the **TruckRouteRequest**. It 
diff --git a/controls/map/providers/overview.md b/controls/map/providers/overview.md
@@ -12,6 +12,7 @@ position: 0
 
 The __RadMap__ control needs a provider of imagery data in order to display a map. Currently, __RadMap__ supports the following providers:
 
+* [AzureMap Custom Provider]({%slug winforms/map/providers/azure%})
 * [BingRestMapProvider]({%slug winforms/map/providers/bingrestmapprovider%})
 * [OpenStreetMapProvider]({%slug winforms/map/providers/openstreetmapprovider%})
 * [LocalMapProvider]({%slug winforms/map/providers/localmapprovider%})
diff --git a/knowledge-base/bing-map-not-loading.md b/knowledge-base/bing-map-not-loading.md
@@ -23,6 +23,8 @@ This article shows how to handle this unexpected behavior and load the map tiles
 
 ## Solution
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 **BingRestMapProvider** internally loads tile data from the [Bing Maps](https://www.bingmapsportal.com/) REST service which requires **TLS 1.2** coming automatically with .NET Framework 4.7. It is necessary to ensure the version explicitly by setting the System.Net.ServicePointManager.**SecurityProtocol** property to SecurityProtocolType.**Tls12**. More information is available here: [Transport Layer Security (TLS) best practices with the .NET Framework](https://learn.microsoft.com/en-us/dotnet/framework/network-programming/tls).
 
 
diff --git a/knowledge-base/create-map-image-silently.md b/knowledge-base/create-map-image-silently.md
@@ -24,6 +24,8 @@ Learn how to export **RadMap** to an image silently from a Console application.
 
 ## Solution 
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 The required assemblies that should be referred:
 
 * System.Windows.Forms.dll
diff --git a/knowledge-base/create-map-rectangle-ellipse-shapes.md b/knowledge-base/create-map-rectangle-ellipse-shapes.md
@@ -24,6 +24,8 @@ This tutorial demonstrates how draw rectangle and ellipse shapes in the WinForms
 
 ## Solution 
  
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+ 
 Telerik UI for WinForms suite does not provide MapRectangle and MapEllipse shapes in RadMap out of the box. However, you can create your own MapRectangle and MapEllipse classes that inherit MapPoint and add your custom logic. Then you can use them as follows: 
 
 ````C#
diff --git a/knowledge-base/radmap-pins-with-an-image.md b/knowledge-base/radmap-pins-with-an-image.md
@@ -30,6 +30,8 @@ res_type: kb
 
 ## Solution
 
+>important Please note that [Bing Maps](https://www.bingmapsportal.com/) __will be deprecated effective June 30, 2025__. As an alternative, users can refer to the [SDK example available in our GitHub repository](https://github.com/telerik/winforms-sdk/tree/master/Map/Custom%20Azure%20Provider), which demonstrates how to create a __custom provider__ using the __Azure Maps API__. A __valid Azure Maps subscription key__ is required to use this functionality.
+
 The image below demonstrates the end result utilizing the custom pin.
 
 >caption Figure 1: Pin with an Image
