BingMapsImageryProvider - Cesium Documentation

new LSGlobe.BingMapsImageryProvider(options)

Bing Maps影像服务提供者

Name Type Description

options

Object

对象具有以下属性:

Name	Type	Default	Description
`url`	Resource \| String		Bing Maps服务url。
`key`	String		optional 应用程序所使用的key，可至官网https://www.bingmapsportal.com/申请。如果未提供key。将使用BingMapsApi.defaultKey；如果BingMapsApi.defaultKey也未定义, 将写入消息提醒您创建申请。使用Bing Maps时在没有创建单独key情况下不能部署应用程序
`tileProtocol`	String		optional 加载瓦片时使用的协议，例如 'http:'或'https:'。默认情况下，使用与页面相同的协议加载
`mapStyle`	BingMapsStyle	`BingMapsStyle.AERIAL`	optional 服务类型
`culture`	String	`''`	optional 请求服务时使用的文化（语言），详细情况参加http://msdn.microsoft.com/en-us/library/hh441729.aspx
`ellipsoid`	Ellipsoid		optional 椭球体。默认为WGS84椭球体
`tileDiscardPolicy`	TileDiscardPolicy		optional 请求的代理。此对象有一个getURL函数，如果需要，返回代理的URL

Example:

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

See:

ArcGisMapServerImageryProvider
GoogleEarthEnterpriseMapsProvider
createOpenStreetMapImageryProvider
SingleTileImageryProvider
createTileMapServiceImageryProvider
WebMapServiceImageryProvider
WebMapTileServiceImageryProvider
UrlTemplateImageryProvider
Bing Maps REST Services
Cross-Origin Resource Sharing

Members

readonlycredit : Credit

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

readonlyculture : String

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

defaultGamma : Number

默认ImageryLayer#gamma用于为此提供程序创建的图像图层。在ImageryLayer创建后更改此值不起作用。而是设置图层的ImageryLayer#gamma属性

Default Value: 1.0

readonlyerrorEvent : Event

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

readonlyhasAlphaChannel : Boolean

获取一个值，该值指示此图像提供者是否包含Alpha通道。如果此属性为false，则忽略Alpha通道（如果存在）。如果此属性为true，则没有任何Alpha通道的图像都将被视为其alpha值为1.0，将此属性设置为false，可减少内存的使用和纹理上载的时间

readonlykey : String

获取服务的key

readonlymapStyle : BingMapsStyle

获取要加载的Bing地图图像类型

readonlymaximumLevel : Number

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

readonlyminimumLevel : Number

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

readonlyproxy : Proxy

请求的代理

readonlyready : Boolean

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

readonlyreadyPromise : Promise.<Boolean>

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

readonlyrectangle : Rectangle

获取所提供图像的矩形,BingMapsImageryProvider#ready返回true之前不能调用此函数

readonlytileDiscardPolicy : TileDiscardPolicy

获取切片放弃策略。如果未定义，则丢弃策略负责通过其shouldDiscardImage函数过滤掉“丢失”的切片。如果此函数返回undefined，则不会过滤任何切片

readonlytileHeight : Number

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

readonlytileWidth : Number

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

readonlytilingScheme : TilingScheme

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

readonlyurl : String

获取服务的url

Methods

staticLSGlobe.BingMapsImageryProvider.quadKeyToTileXY(quadkey)

将用于从Bing Maps服务器请求图像的quadkey转换为（x, y, level）位置

Name	Type	Description
`quadkey`	String	瓦片的quadkey

See:

Bing Maps Tile System
BingMapsImageryProvider#tileXYToQuadKey

staticLSGlobe.BingMapsImageryProvider.tileXYToQuadKey(x, y, level)

将瓦片（x, y, level）位置转换为Bing Maps服务器请求图像的quadkey

Name	Type	Description
`x`	Number	瓦片的x坐标
`y`	Number	瓦片的y坐标
`level`	Number	缩放的级别

See:

Bing Maps Tile System
BingMapsImageryProvider#quadKeyToTileXY

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

获取在显示时给定瓦片的credits

Name	Type	Description
`x`	Number	瓦片的x坐标
`y`	Number	瓦片的y坐标
`level`	Number	瓦片层级

Returns:

瓦片的credits

Throws:

DeveloperError : getTileCredits在影像准备就绪之前，不得调用它

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

当前图像不支持拾取功能时，返回undefined

Name	Type	Description
`x`	Number	瓦片的x坐标
`y`	Number	瓦片的y坐标
`level`	Number	瓦片的层级
`longitude`	Number	选择要素的经度
`latitude`	Number	选择要素的纬度

Returns:

选择要素在异步完成。选择的对象时一个@link ImageryLayerFeatureInfo}实例数组。如果在给定位置没有发现任何特性，数组可能为空。如果不支持选择，也可能为undefined

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	optional 请求对象。仅供内部使用

Returns:

当图像可用时保证图像可以请求到。如果对服务器有太多请求则为undefined，并且稍后将重试该请求。解析的图像可以是Image或Canvas DOM对象。

Throws:

DeveloperError : requestImage 在影像准备就绪之前不得调用