Show / Hide Table of Contents

Class BingMapsLayer

A layer for displaying Bing Maps.

Inheritance
Object
Layer
ImageAdjustmentLayer
ImageTiledLayer
ServiceImageTiledLayer
BingMapsLayer
Implements
INotifyPropertyChanged
ILoadable
ILayerContent
ImageTiledLayer.TileInfo
ImageTiledLayer.FullExtent
ImageTiledLayer.GetTileDataAsync(Int32, Int32, Int32, CancellationToken)
ImageTiledLayer.NoDataTileBehavior
ImageAdjustmentLayer.Brightness
ImageAdjustmentLayer.Contrast
ImageAdjustmentLayer.Gamma
Layer.LoadAsync()
Layer.CancelLoad()
Layer.RetryLoadAsync()
Layer.LoadStatus
Layer.LoadError
Layer.Item
Layer.Attribution
Layer.Description
Layer.MaxScale
Layer.MinScale
Layer.SpatialReference
Layer.Opacity
Layer.Id
Layer.Clone()
Layer.CanChangeVisibility
Layer.IsVisible
Layer.IsIdentifyEnabled
Layer.Name
Layer.ShowInLegend
Layer.SublayerContents
Layer.GetLegendInfosAsync()
Layer.IsVisibleAtScale(Double)
Layer.PropertyChanged
Layer.OnPropertyChanged(String)
Layer.Loaded
Layer.LoadStatusChanged
Object.Equals(Object)
Object.Equals(Object, Object)
Object.GetHashCode()
Object.GetType()
Object.MemberwiseClone()
Object.ReferenceEquals(Object, Object)
Object.ToString()
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 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 Maps SDK for .NET 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

TargetVersions
.NET Standard 2.0100.3 - 200.0
.NET 6.0100.13 - 200.0
.NET 6.0 Windows100.13 - 200.0
.NET 6.0 Android200
.NET 6.0 iOS200
.NET Framework100.1 - 200.0
.NET 5100.10 - 100.12
.NET Core 3.1100.7 - 100.12
Android100.1 - 100.15
iOS100.1 - 100.15
UWP100.1 - 200.0
In This Article
Back to top Copyright © 2022 Esri.