Class: BingMapsImageryProvider

var bing = new SuperMap3D.BingMapsImageryProvider({
    url : 'https://dev.virtualearth.net',
    key : 'get-yours-at-https://www.bingmapsportal.com/',
    mapStyle : SuperMap3D.BingMapsStyle.AERIAL
});

Members

static logoUrlString

Retrieve or set the URL of the Bing logo displayed in copyright information.

readonly creditCredit

Retrieve service description information when the service is active.

readonly cultureString

Please refer to the language used when requesting Bing Maps service for details http://msdn.microsoft.com/en-us/library/hh441729.aspx .

defaultGammaNumber

The default ImageryLayer # gamma value used for image layers created by this provider. Changing this value after creating an ImageryLayer for this provider will be invalid. On the contrary, the ImageryLayer # gamma attribute of this layer should be set.

Default Value:

1.0

Methods

static quadKeyToTileXY(quadkey)

Request an image from the Bing Maps server and convert a tile's quadkey to (x, y, level) position.

Name	Type	Description
quadkey	String	The four key of the tile.

See:

• Bing Maps Tile System
• BingMapsImageryProvider#tileXYToQuadKey

static tileXYToQuadKey(x, y, level)

Convert the (x, y, level) position of a tile into a quadkey and request an image from the Bing Maps server.

Name	Type	Description
x	Number	The x-coordinate of the tile.
y	Number	The y-coordinate of the tile.
level	Number	The scaling level of tiles.

See:

• Bing Maps Tile System
• BingMapsImageryProvider#quadKeyToTileXY

getTileCredits(x, y, level){Array.<Credit>}

Obtain subtitle information displayed on tiles.

Name	Type	Description
x	Number	The x-coordinate of the tile.
y	Number	The y-coordinate of the tile.
level	Number	The level of tiles.

Throws:

GetTileCredits is prohibited from being called before providing imaging services.

Type

DeveloperError

Returns:

Type	Description
Array.<Credit>	Subtitle information displayed on tiles.

pickFeatures(x, y, level, longitude, latitude){Promise.<Array.<ImageryLayerFeatureInfo>>|undefined}

Pick up feature objects. If the image provider currently does not support the pickup function, the function will return undefined. ClippingType.js

Name	Type	Description
x	Number	The x-coordinate of the tile.
y	Number	The y-coordinate of the tile.
level	Number	The level of tiles.
longitude	Number	Pick the longitude of the feature object.
latitude	Number	Pick the latitude of the feature object.

Returns:

Type	Description
Promise.<Array.<ImageryLayerFeatureInfo>> | undefined	When the asynchronous picking operation is completed, a promise for selecting features will be formed. The value of the promise is the ImageryLayerElementInfo instance array. If no feature object is found at the specified location, the array will be empty. If picking operation is not supported, it may be because the operation object is undefined.

requestImage(x, y, level, request){Promise.<(Image|Canvas)>|undefined}

Request to specify the image of the tile. When BingMapsImagryProvider # ready returns true, this function is called.

Name	Type	Description
x	Number	The x-coordinate of the tile.
y	Number	The y-coordinate of the tile.
level	Number	The level of tiles.
request	Request	optional Request object. For internal use only.

Throws:

RequestImage is prohibited from being called before providing image services.

Type

DeveloperError

Returns:

Type	Description
Promise.<(Image|Canvas)> | undefined	When the image is available, a promise is formed for the image, or if it is undefined (if the server receives too many requests, the request is prompted to retry later). The parsed image can be an image or a Canvas DOM object.