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.
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).
-
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.
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.
UriImageProvider
RadMap provides support for single image provider through the UriImageProvider
class besides the built-in support for tiled (MultiScaleImage) providers like 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 read here.
ArcGIS online services
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.