Class: BingMapsImageryProvider

BingMapsImageryProvider

new BingMapsImageryProvider()

Bing Maps影像服务provider。

Name Type Default Description
options.url String

Bing Maps服务url。
options.key String 可选

应用程序所使用的key，可至官网https://www.bingmapsportal.com/申请。如果未提供key，将使用BingMapsApi.defaultKey；如果BingMapsApi.defaultKey也未定义，将写入消息提醒您创建申请。使用Bing Maps时，在没有创建单独key的情况下不能部署应用程序。
options.tileProtocol String 可选

加载瓦片时使用的协议，例如 'http:'或'https:'。默认情况下，使用与页面相同的协议加载。
options.mapStyle BingMapsStyle BingMapsStyle.AERIAL 可选

服务类型。
options.culture String '' 可选

详细内容请参考http://msdn.microsoft.com/en-us/library/hh441729.aspx。
options.ellipsoid Ellipsoid 可选

椭球体。未定义时默认使用WGS84椭球体。
options.tileDiscardPolicy TileDiscardPolicy 可选

确定瓦片是否无效及废弃的策略。未指定时默认使用DiscardMissingTileImagePolicy。
options.proxy Proxy 可选

请求的代理。此对象有一个getURL函数，如果需要，返回代理的URL。
See:
Example
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

获取或设置在版权信息中显示的Bing徽标的URL。

readonly creditCredit

服务处于活动时获取服务的描述信息。

readonly cultureString

获取请求Bing Maps服务时使用的语言，详情请参见http://msdn.microsoft.com/en-us/library/hh441729.aspx。

defaultGammaNumber

此提供程序创建的图像层默认使用的ImageryLayer#gamma值。 在为此提供程序创建ImageryLayer后更改此值将无效。 相反，应设置该层的ImageryLayer#gamma属性。

Default Value:
1.0

readonly errorEventEvent

获取影像服务发生异步错误时引发的事件。事件侦听器传递TileProviderError的一个实例。

readonly hasAlphaChannelBoolean

获取一个值指示影像提供者提供的影像是否包含alpha通道。如果此属性为false,则alpha通道（如果存在）将被忽略。如果此属性为true，则没有alpha通道的任意影像被视为其alpha值为1。将此值设置为false会减少内存的使用及纹理加载时间。

readonly keyString

获取服务的key。

readonly mapStyleBingMapsStyle

获取服务类型。

readonly maximumLevelNumber

获取可以请求的最大级别(LOD)。在BingMapsImageryProvider#ready返回true前此属性不能调用。

readonly minimumLevelNumber

获取可以请求的最小级别(LOD)。在BingMapsImageryProvider#ready返回true前此属性不能调用。

readonly proxyProxy

获取服务提供者使用的代理。

readonly readyBoolean

获取一个用于指示服务是否可供使用的值。

readonly readyPromisePromise.<Boolean>

服务可供使用时获取解析为true的promise。

readonly rectangleRectangle

获取通过实例提供的影像矩形、弧度参数。@link BingMapsImageryProvider#ready返回真时调用此函数。

readonly tileDiscardPolicyTileDiscardPolicy

获取瓦片舍弃策略。如果未定义，舍弃策略通过shouldDiscardImage功能滤除不存在的瓦片。如果函数返回未定义，则没有滤除任何瓦片。BingMapsImageryProvider#ready返回真时调用此函数。

readonly tileHeightNumber

获取每个瓦片的高度，以像素为单位。在BingMapsImageryProvider#ready返回true前此属性不能调用。

readonly tileWidthNumber

获取每个瓦片的宽度，以像素为单位。在BingMapsImageryProvider#ready返回true前此属性不能调用。

readonly tilingSchemeTilingScheme

获取服务provider使用的剖分策略。在BingMapsImageryProvider#ready返回true前此属性不能调用。

readonly urlString

获取服务的url。

Methods

static quadKeyToTileXY(quadkey)

从Bing Maps服务器请求影像，将一个瓦片的四叉键转换成(x, y, level)位置。

Name Type Description
quadkey String

瓦片的四叉键。
See:

static tileXYToQuadKey(x, y, level)

将一个瓦片的(x, y, level)位置转换成四叉键，从Bing Maps服务器请求影像。

Name Type Description
x Number

瓦片的x坐标。
y Number

瓦片的y坐标。
level Number

瓦片的缩放级别。
See:

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

获取瓦片显示的字幕信息。

Name Type Description
x Number

瓦片的x坐标。
y Number

瓦片的y坐标。
level Number

瓦片的级别。
Throws:

getTileCredits 在影像服务提供前禁止调用。

Type
DeveloperError
Returns:
Type Description
Array.<Credit> 瓦片显示的字幕信息。

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

拾取特征对象。如果影像提供者当前不支持拾取功能，函数将返回未定义。ClippingType.js

Name Type Description
x Number

瓦片的x坐标。
y Number

瓦片的y坐标。
level Number

瓦片的级别。
longitude Number

拾取特征对象的经度。
latitude Number

拾取特征对象的纬度。
Returns:
Type Description
Promise.<Array.<ImageryLayerFeatureInfo>> | undefined 异步拾取操作完成时将形成选取特征的promise。promise的值是ImageryLayerFeatureInfo实例数组。如果在指定位置未发现特征对象，数组将为空值。如果不支持拾取操作，可能是操作对象未定义。

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

请求指定瓦片的影像。BingMapsImageryProvider#ready返回true时此函数被调用。

Name Type Description
x Number

瓦片的x坐标。
y Number

瓦片的y坐标。
level Number

瓦片的级别。
request Request 可选

请求对象。只供内部使用。
Throws:

requestImage 在影像服务提供前禁止调用。

Type
DeveloperError
Returns:
Type Description
Promise.<(Image|Canvas)> | undefined 当影像可用时形成影像的promise，或是未定义（如果服务器接收太多的请求，请求被提示稍后重试）。解析后的影像可以是影像或是Canvas DOM对象。