New to Telerik UI for WinForms? Download free 30-day trial


RadMap can visualize tile data from the Bing Maps REST service. You can enable tile caching to a local folder by setting a new LocalFileCacheProvider to the BingRestMapProvider.CacheProvider property.

Figure 1: BingRestMapProvider

WinForms RadMap BingRestMapProvider

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.

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.

BingRestMapProvider internally loads tile data from the Bing Maps 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.

Using BingRestMapProvider

string cacheFolder = @"..\..\cache";
BingRestMapProvider bingProvider = new Telerik.WinControls.UI.BingRestMapProvider();
bingProvider.UseSession = true;
bingProvider.BingKey = bingKey;
LocalFileCacheProvider cache = new LocalFileCacheProvider(cacheFolder);
bingProvider.CacheProvider = cache;

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

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] If you are using .Net Framework 4.0 this is not required.


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
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.

The ImagerySet.OrdnanceSurvey is only visible in the Great Britain area and in between zoom levels of 10 and 17.


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.


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

In this article