Providers Overview
The RadMap
control doesn't display a map on itself, it needs a map provider from which to consume the required data. Currently the control supports a few providers:
It is now possible to specify multiple map providers that will be displayed one over another through the
Providers
property of RadMap. Note that in multiple providers scenario the first (master) provider should be tiled provider without geographic limits set. Also, providers that have geographic limits and use tiled map sources should be limited with theMapLayer.ZoomRange
attached property. Zoom range should be set into the reasonable value, so the size of the “map window” does not get excessive on the maximum allowed zoom level; otherwise loading of the tiles into the window will dramatically decrease performance of the application.
Attribution Copyright Label
Each provider of the RadMap control that displays third-party imagery data must display an attribution copyright label. For more information about the accurate copyright label's content, please refer to the attribution article of each of the third-party vendor.
To learn how to customize the RadMap to allocate space for displaying an element containing a sample attribution copyright label, check this article.
Common Providers API
Here is a list of the most important common properties shared by all map providers:
-
GeoBounds
—Gets or sets region covered by map image (the region represented by map provider can be limited by geographic bounds now).
-
Opacity
—Gets or sets the opacity factor for the respective provider imagery data.
-
Commands
—Gets the collection of the commands supported by the respective provider. This is useful if you want to customize the default command list (i.e. add / remove commands). You can find more information here.
-
CommandBindingCollection
—Gets collection of the command bindings.
-
SupportedSources
—Gets the IDs of the supported sources. This property can be used in scenarios where it is necessary to get the list of supported sources and execute some action based on them (e.g. enable or disable source specific commands in the command bar).
Bing Maps Provider
The RadMap control provides the support to visual Bing Maps tile data via the BingRestMapProvider
(RESTful imagery service) class.
For more information about the Bing Maps support, check the Bing Map Rest Provider article.
The Bing Maps REST Services is deprecated. The BingRestMapProvider will be supported until 2026 Q2 inclusive. To avoid disruptions, you can use the Azure Maps Services, which are supported by the RadMap control via the AzureMapProvider.
OpenStreet Maps Provider
RadMap supports displaying tile data from the Open Street Map services via the OpenStreetMapProvider
class.
To learn more about the Open Street Map services support, check the Open Street Map Provider article.
Empty Provider
The EmptyProvider
is a provider which doesn't connect to any real imagery services (Virtual Earth, Google etc). It provides definitions and methods which can be used to calculate positions of the framework elements, map shapes and pin points. By using this provider you can create map-relative applications which do not require visibility of the real map data (landscapes or roads), but which require visible elements to be positioned according to the geographical coordinates.
To learn more about the EmptyProvider, check the Empty Provider article.
UriImage Provider
RadMap provides support for single image provider through the UriImageProvider
class besides the built-in support for tiled (MultiScaleImage) providers like BingRestMapProvider and OpenStreetMapProvider. You can either use it with single image for all zoom levels, or you can specify an image for every distinct zoom level.
To learn more about the UriImageProvider, check the UriImageProvider article.
ArcGIS Provider
RadMap exposes the functionality to display the ArcGIS online services via the ArcGisMapProvider
class.
To learn more about the ArcGisMapProvider, check the ArcGIS Online Map Provider article.
Azure Maps Provider
The RadMap control supports displaying tile data using the Azure Map services. This is done via the AzureMapProvider
class and it provides support for both raster and vector sources.
For more information about the Azure Map services support, check the Azure Map Provider article.
MapBox Provider
RadMap provides support for the MapBox vector tile services via the MapBoxProvider
class.
To learn more about how to use the MapBoxProvider, check the MapBox Provider article.