# 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 ![WinForms RadMap BingRestMapProvider](https://www.telerik.com/products/winforms/documentation/assets/a63e59881f666fed336e6f137bcd8268/map-bingrestmapprovider001.png) > note You must provide a Bing Maps Key to the provider for it to work. To get your free Bing Maps Key, please refer to the following link: [Getting a Bing Maps Key](https://msdn.microsoft.com/en-us/library/ff428642.aspx). > note Only billable transactions count towards the free-use limits for Basic keys, and Enterprise keys are only charged for billable transactions. Non-billable transactions do not incur charges and do not count towards free-use limits. You can find additional information in the following link: [Billable versus non-billable transactions](https://msdn.microsoft.com/en-us/library/ff859477.aspx). > caution **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. For older .NET Frameworks, or because of some other Windows settings, it may be necessary to explicitly choose TLS 1.2 for your application 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). #### Using BingRestMapProvider ```C# string cacheFolder = @"..\..\cache"; BingRestMapProvider bingProvider = new Telerik.WinControls.UI.BingRestMapProvider(); bingProvider.UseSession = true; bingProvider.BingKey = bingKey; LocalFileCacheProvider cache = new LocalFileCacheProvider(cacheFolder); bingProvider.CacheProvider = cache; this.radMap1.Providers.Add(bingProvider); ``` ```VB.NET Dim cacheFolder As String = "..\..\cache" Dim bingProvider As BingRestMapProvider = New Telerik.WinControls.UI.BingRestMapProvider() bingProvider.UseSession = True bingProvider.BingKey = bingKey Dim cache As New LocalFileCacheProvider(cacheFolder) bingProvider.CacheProvider = cache Me.radMap1.Providers.Add(bingProvider) ``` > note If you use **RadMap** with .Net Framework 2.0 and you don't have an installation of the Telerik UI for WinForms suite on the current machine, it is necessary to add a reference to the Newtonsoft.Json assembly which can be found in the \Bin folder of the *Telerik_UI_For_WinForms\_\[version]\_Dev_dlls.zip*. If you are using .Net Framework 4.0 this is not required. # Properties | Property | Description | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **BingKey** | Gets or sets the Bing key. | | **UseSession** | Gets or sets a value indicating whether to use session key. | | **SessionId** | Gets the session identifier. | | **ImagerySet** | Gets or sets the imagery set. The possible values are: *Aerial*, *AerialWithLabels*, *AerialWithLabelsOnDemand*,*Road*, *RoadOnDemand*, *CanvasDark*, *CanvasLight*, *CanvasGray*, *OrdnanceSurvey*. ![WinForms RadMap ImagerySet](https://www.telerik.com/products/winforms/documentation/assets/30a352771f1fcc5675f6085b31f8053e/map-bingrestmapprovider002.png) | | **Initializing** | Gets or sets a value indicating whether this **BingRestMapProvider** is currently in the initialization process. | | **Initialized** | Gets or sets a value indicating whether this **BingRestMapProvider** is initialized. | | **MaxZoomLevel** | Gets or sets the maximum zoom level. | | **MinZoomLevel** | Gets or sets the minimum zoom level. | | **TileSize** | Gets the tile size. | | **CacheProvider** | Gets or sets the provider used for data caching. | | **EnableCaching** | Gets or set a value whether the caching is enabled. | | **TileDownloader** | Gets or sets the tile downloader. | > note The **ImagerySet**.*OrdnanceSurvey* is only visible in the Great Britain area and in between zoom levels of 10 and 17. # Methods | Method | Description | | --------------------------- | --------------------------------------------------------------------------------------- | | **Initialize** | Initializes this provider. | | **GetTile** | Gets the tile uri. | | **GetTileImage** | Gets the tile image. | | **CalculateRouteAsync** | Calculates the route asynchronously. | | **SearchAsync** | Performs search request asynchronously. | | **CalculateElevationAsync** | Calculates the elevation asynchronously. | | **GetSupportedViews** | Gets the supported views. BingRestMapProvider supports *Aerial* and *Road* MapViewInfo. | | **SetView** | Sets the view in the BingRestMapProvider. | # Events | Event | Description | | ------------------------------- | ------------------------------------------------------------------------- | | **InitializationComplete** | Fires when the initialization is completed. | | **InitializationError** | Fires when an error during the initialization occurs. | | **ProviderUpdated** | Fires when the provider has been updated, e.g. when a tile is downloaded. | | **CalculateRouteCompleted** | Fires when the route calculation is completed. | | **CalculateRouteError** | Fires when an error occurs during route calculating. | | **SearchCompleted** | Fires when the search request has completed. | | **SearchError** | Fires when an error | | **CalculateElevationCompleted** | Fires when the elevation calculations is completed. | | **CalculateElevationError** | Fire when an error occurs duriong elevation calculating. | ## See Also * [Search](https://www.telerik.com/products/winforms/documentation/controls/map/providers/bingmaps/search) * [Route](https://www.telerik.com/products/winforms/documentation/controls/map/providers/bingmaps/route) * [Elevation](https://www.telerik.com/products/winforms/documentation/controls/map/providers/bingmaps/elevation/elevation) * [How to Create Map Image Silently](https://www.telerik.com/products/winforms/documentation/knowledge-base/create-map-image-silently) * [How to Deal with Empty RadMap using BingRestMapProvider](https://www.telerik.com/products/winforms/documentation/knowledge-base/bing-map-not-loading)