Skip To Content ArcGIS for Developers Sign In Dashboard

BingMapsLayer Class

class Esri::ArcGISRuntime::BingMapsLayer

A Bing Maps layer displays map content from a Bing Maps web service. More...

Header: #include <BingMapsLayer>
Since: Esri::ArcGISRuntime 100.1
Inherits: Esri::ArcGISRuntime::ServiceImageTiledLayer

This class was introduced in Esri::ArcGISRuntime 100.1.

Public Functions

BingMapsLayer(Esri::ArcGISRuntime::Portal *portal, Esri::ArcGISRuntime::BingMapsLayerStyle style, QObject *parent = nullptr)
BingMapsLayer(const QString &bingMapsKey, Esri::ArcGISRuntime::BingMapsLayerStyle style, QObject *parent = nullptr)
virtual ~BingMapsLayer() override
QString culture() const
QString key() const
Esri::ArcGISRuntime::Portal *portal() const
void setCulture(const QString &culture)
void setKey(const QString &bingMapsKey)
Esri::ArcGISRuntime::BingMapsLayerStyle style() const

Detailed Description

Functional characteristics

Bing maps require an API key from Microsoft. A Bing maps key may be provided via a portal that has one, or with a string at load time. See Microsoft’s documentation for details on Getting a Bing Maps Key. If the layer does not have a Bing map key or a portal where it can get the Bing map key when load is called, the layer will fail to load.

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.

Usage of BingMapsLayer in ArcGIS Runtime requires adherence to Microsoft's Mobile Brand Guidelines.

Member Function Documentation

BingMapsLayer::BingMapsLayer(Esri::ArcGISRuntime::Portal *portal, Esri::ArcGISRuntime::BingMapsLayerStyle style, QObject *parent = nullptr)

Constructor that takes a portal, style, and an optional parent.

BingMapsLayer::BingMapsLayer(const QString &bingMapsKey, Esri::ArcGISRuntime::BingMapsLayerStyle style, QObject *parent = nullptr)

Constructor that takes a bingMapsKey, style, and an optional parent.

[override virtual] BingMapsLayer::~BingMapsLayer()

Destructor.

QString BingMapsLayer::culture() const

Returns the culture for the layer.

The culture affects the localization of certain items, such as street names or country names.

See Supported culture codes.

Note: the culture cannot be changed after the layer is loaded.

See also setCulture().

QString BingMapsLayer::key() const

Returns the Bing Maps key.

See also setKey().

Esri::ArcGISRuntime::Portal *BingMapsLayer::portal() const

Returns the Portal the layer loaded its Bing Maps API key from.

void BingMapsLayer::setCulture(const QString &culture)

Sets the culture for the layer to culture.

The culture affects the localization of certain items, such as street names or country names.

See Supported culture codes.

Note: the culture cannot be changed after the layer is loaded.

See also culture().

void BingMapsLayer::setKey(const QString &bingMapsKey)

Sets the Bing Maps key to bingMapsKey.

See also key().

Esri::ArcGISRuntime::BingMapsLayerStyle BingMapsLayer::style() const

Returns the BingMapsLayerStyle for the layer.


Feedback on this topic?