Class BingMapsLayer
A layer for displaying data from a Bing Maps web service.
Inheritance
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class BingMapsLayer : ServiceImageTiledLayer, INotifyPropertyChanged, ILoadable, ILayerContent
Remarks
A Bing maps layer displays map content from a Bing Maps web service, providing access to static map tiles and imagery meta-data. Map style and culture can be customized prior to loading the layer.
Functional characteristics
Bing maps require an API key from Microsoft. There are two ways to set this key:
- By providing an ArcGISPortal configured with a Bing Maps key. For more information, see "How to install a Microsoft Bing Key".
- By providing a Bing Maps key directly for this layer. For more information, see "Getting a Bing Maps Key".
The Bing maps layer will fail to load if it does not have a Bing map key or a Portal from where it can get the Bing map key. In this situation, you could set the Key and call RetryLoadAsync().
To use a Bing maps layer you must adhere to Microsoft's Mobile Brand Guidelines.
Bing maps layers do not support identify, query, selection, or time.
Performance characteristics
Bing maps layers perform similarly to other tiled layers. Raster tiles are fetched from Bing's servers on demand.
Constructors
Name | Description |
---|---|
BingMapsLayer(ArcGISPortal, BingMapsLayerStyle) | Initializes a new instance of the BingMapsLayer class with style, and using Bing Maps API key provided by the given Portal. |
BingMapsLayer(String, BingMapsLayerStyle) | Initializes a new instance of the BingMapsLayer class with the given style and Bing Maps API key. |
Properties
Name | Description |
---|---|
Culture | Gets or sets the culture of this Bing maps layer. |
Key | Gets or sets the Bing Maps API key for this layer. |
Portal | Gets the Portal from which this layer got its Bing Maps API key (if applicable). |
Style | Gets or sets the map style used to display this Bing Maps layer. |
Methods
Name | Description |
---|---|
GetTileUriAsync(Int32, Int32, Int32, CancellationToken) | This method is not currently supported and always throws a System.NotSupportedException. |
Applies to
Target | Versions |
---|---|
.NET Standard 2.0 | 100.3 - 200.5 |
.NET | 100.13 - 200.5 |
.NET Windows | 100.13 - 200.5 |
.NET Android | 200.0 - 200.5 |
.NET iOS | 200.0 - 200.5 |
.NET Framework | 100.1 - 200.5 |
Xamarin.Android | 100.1 - 100.15 |
Xamarin.iOS | 100.1 - 100.15 |
UWP | 100.1 - 200.5 |