使用Bing Maps图像REST API提供瓦片图像。
| Name | Type | Description | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
此对象拥有以下属性：
|
Example:
var bing = new Cesium.BingMapsImageryProvider({
url : 'https://dev.virtualearth.net',
key : 'get-yours-at-https://www.bingmapsportal.com/',
mapStyle : Cesium.BingMapsStyle.AERIAL
});See:
Members
获取或设置Bing Map的Logo的URL，以在版权中显示。
readonlycredit : Credit
获取版权信息。在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
请求必应地图图像时要使用的区域性。 并非所有culture都受支持。
有关受支持的区域性的信息，请参见http://msdn.microsoft.com/zh-cn/library/hh441729.aspx。
为该提供器创建的图像图层使用的默认
ImageryLayer#gamma。
在为这个提供器创建ImageryLayer之后更改这个值将没有任何效果。相反，设置图层的ImageryLayer#gamma属性。
-
Default Value:
1.0
readonlyerrorEvent : Event
获取此提供器遇到异步错误时触发的事件。
通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个
TileProviderError的实例。
获取影像是否有Alpha通道。
获取 Bing Maps key。
readonlymapStyle : BingMapsStyle
获取地图样式。
获取请求的最大级别。
在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
获取请求的最小级别。在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
获取此提供器使用的代理。
获取一个值，该值指示提供器是否已准备好使用。
获取一个在提供器准备就绪时可以解析为true的Promise。
readonlyrectangle : Rectangle
获取要显示的地图范围（以弧度表示）。
在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
readonlytileDiscardPolicy : TileDiscardPolicy
获取瓦片忽略策略。如果未定义，则丢弃策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义，则不过滤任何切片。 在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
获取瓦片高，以像素为单位。在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
获取瓦片宽，以像素为单位。在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
readonlytilingScheme : TilingScheme
获取切片方案。
在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
获取托管图像的BingMaps服务器url的名称。
Methods
将用于从Bing Maps服务器请求图像的瓦片的quad key转换为（x，y，level）位置。
| Name | Type | Description |
|---|---|---|
quadkey |
String | quad key |
- Bing Maps Tile System
- BingMapsImageryProvider#tileXYToQuadKey
See:
将瓦片（x，y，级别）位置转换为用于从Bing Maps服务器请求图像的QuadKey。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
- Bing Maps Tile System
- BingMapsImageryProvider#quadKeyToTileXY
See:
getTileCredits(x, y, level) → Array.<Credit>
获取当请求的瓦片被显示出来时，要显示的版权信息。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
Returns:
返回的版权。
Throws:
-
DeveloperError : 在图像提供器准备就绪之前，不得调用
getTileCredits。
pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
这个图像提供器目前不支持拾取功能，所以这个函数只是返回未定义。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的级别。 |
longitude |
Number | 拾取要素的经度。 |
latitude |
Number | 拾取要素的纬度。 |
Returns:
对所选要素的promise，它将在异步拾取完成时解析。
解析后的值是
ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。
如果不支持拾取，它也可能是未定义的。
请求给定块的瓦片。在
BingMapsImageryProvider#ready 返回true之前，不应调用此函数。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
request |
Request | optional Request对象（仅供内部使用）。 |
Returns:
返回值有以下3种情况：
1.当图像可用时，返回对图像的Promise。
2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。
3.解析后的图像可以是图像，也可以是画布DOM对象。
Throws:
-
DeveloperError : 准备好图像提供器之前，不得调用
requestImage。