Class BingMapsLayer
A layer for displaying Bing Maps.
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public sealed class BingMapsLayer : ServiceImageTiledLayer, INotifyPropertyChanged, ILoadable, ILayerContent, ICoreInstanceOwner, ICoreCallback_Layer_VisibilityChangedRemarks
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 BingMapsLayer 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().
Usage of BingMapsLayer in ArcGIS Runtime requires adherence 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 that should be displayed by a Bing Maps layer. |
Methods
| Name | Description |
|---|---|
| GetTileUriAsync(Int32, Int32, Int32, CancellationToken) | This method is not currently supported and always throws a NotSupportedException. |
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.13.0, 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0, 100.6.0, 100.5.0, 100.4.0, 100.3.0 |
| .NET 6.0 | 100.13.0 |
| .NET 6.0 Windows | 100.13.0 |
| .NET Framework | 100.13.0, 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0, 100.6.0, 100.5.0, 100.4.0, 100.3.0, 100.2.1, 100.1.0 |
| .NET 5 | 100.12.0, 100.11.2, 100.11.0, 100.10.0 |
| .NET Core | 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0 |
| Xamarin.Android | 100.13.0, 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0, 100.6.0, 100.5.0, 100.4.0, 100.3.0, 100.2.1, 100.1.0 |
| Xamarin.iOS | 100.13.0, 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0, 100.6.0, 100.5.0, 100.4.0, 100.3.0, 100.2.1, 100.1.0 |
| UWP | 100.13.0, 100.12.0, 100.11.2, 100.11.0, 100.10.0, 100.9.0, 100.8.0, 100.7.0, 100.6.0, 100.5.0, 100.4.0, 100.3.0, 100.2.1, 100.1.0 |