使用Bing Maps Images REST API提供平铺图像。
| Name | Type | Description |
|---|---|---|
options |
BingMapsImageryProvider.ConstructorOptions | 描述初始化选项的对象 |
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徽标的URL以在信用证中显示。
readonly credit : Credit
获取此图像提供程序处于活动状态时显示的点数。通常这是用来信用的
图像的来源。在
BingMapsImageryProvider#ready返回true之前，不应调用此函数。请求Bing地图图像时使用的文化。不是
支持所有文化。见http://msdn.microsoft.com/en-us/library/hh441729.aspx
有关支持的区域性的信息。
此提供程序的默认alpha混合值，0.0表示完全透明和
1.0表示完全不透明。
-
Default Value:
undefined
此提供程序的默认亮度。1.0使用未修改的图像颜色。小于1.0
使图像变暗，大于1.0将使图像更亮。
-
Default Value:
undefined
此提供程序的默认对比度。1.0使用未修改的图像颜色。小于1.0减少
大于1.0时，对比度会增加。
-
Default Value:
undefined
默认的alpha混合值，在这个提供程序的全局日侧，0.0表示完全透明和
1.0表示完全不透明。
-
Default Value:
undefined
要应用于此提供程序的默认gamma校正。1.0使用未修改的图像颜色。
-
Default Value:
1.0
此提供程序的默认色调（以弧度为单位）。0.0使用未修改的图像颜色。
-
Default Value:
undefined
defaultMagnificationFilter : TextureMagnificationFilter
要应用于此提供程序的默认纹理放大过滤器。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
要应用于此提供程序的默认纹理缩小筛选器。
-
Default Value:
undefined
默认的alpha混合值出现在这个提供者的地球仪的夜间，0.0表示完全透明
1.0表示完全不透明。
-
Default Value:
undefined
此提供程序的默认饱和度。1.0使用未修改的图像颜色。小于1
大于1.0时的饱和度会增加。
-
Default Value:
undefined
readonly errorEvent : Event
获取在映像提供程序遇到异步错误时引发的事件。通过订阅
对于事件，您将收到错误通知，并可能从中恢复。事件侦听器
传递给
TileProviderError的实例。获取一个值，该值指示此图像提供程序是否提供图像
包括一个alpha通道。如果此属性为false，则alpha通道（如果存在）将
被忽视。如果此属性为true，则将处理没有alpha通道的任何图像
好像他们的alpha到处都是1.0。将此属性设置为false可减少内存使用量
和纹理上传时间。
获取Bing地图密钥。
readonly mapStyle : BingMapsStyle
获取要加载的Bing地图图像的类型。
获取可以请求的最大详细级别。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。获取可请求的最低详细级别。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。readonly proxy : Proxy
获取此提供程序使用的代理。
获取一个值，该值指示提供程序是否可以使用。
获取在提供程序准备好使用时解析为true的承诺。
readonly rectangle : Rectangle
获取此实例提供的图像的矩形（以弧度为单位）。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。readonly tileDiscardPolicy : TileDiscardPolicy
获取磁贴丢弃策略。如果不是未定义，则由丢弃策略负责
用于通过其shouldDiscardImage函数过滤掉“丢失”的瓷砖。如果这个函数
返回未定义的，不过滤分片。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。获取每个平铺的高度（以像素为单位）。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。获取每个平铺的宽度（以像素为单位）。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。readonly tilingScheme : TilingScheme
获取此提供程序使用的平铺方案。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。获取托管映像的BingMaps服务器url的名称。
Methods
将用于从Bing地图服务器请求图像的磁贴的四元键转换为
（x，y，level）位置。
| Name | Type | Description |
|---|---|---|
quadkey |
String | 平铺的四元键 |
- Bing Maps Tile System
- BingMapsImageryProvider#tileXYToQuadKey
See:
将平铺（x、y、level）位置转换为用于请求图像的四元键
从Bing地图服务器。
| 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:
对于所选功能的承诺，将在异步
拣选完成。解析值是一个
ImageryLayerFeatureInfo数组
实例。如果在给定位置找不到特征，则数组可能为空。
如果不支持拣选，也可能未定义。请求给定磁贴的图像。这个功能应该
在
BingMapsImageryProvider#ready返回true之前不调用。| Name | Type | Description |
|---|---|---|
x |
Number | 平铺X坐标。 |
y |
Number | 平铺Y坐标。 |
level |
Number | 平铺层。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
对映像的承诺，当映像可用时将解决该问题，或
如果对服务器的活动请求太多，则未定义
应该稍后重试。解析图像可以是
图像或画布DOM对象。
Throws:
-
DeveloperError ：
requestImage在图像提供商准备就绪之前不得调用。
Type Definitions
BingMapsImageryProvider构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
url |
Resource | String | 托管图像的Bing地图服务器的url。 | ||
key |
String | 你的应用程序的必应地图密钥，可以是 创建于https://www.bingmapsportal.com/。 | ||
tileProtocol |
String |
<optional> |
加载磁贴时使用的协议，例如“http”或“https”。 默认情况下，使用与页面相同的协议加载平铺。 | |
mapStyle |
BingMapsStyle |
<optional> |
BingMapsStyle.AERIAL | 必应的类型映射图像进行加载。 |
culture |
String |
<optional> |
'' | 请求Bing地图图像时使用的文化。不是 支持所有文化。见http://msdn.microsoft.com/en-us/library/hh441729.aspx 有关支持的区域性的信息。 |
ellipsoid |
Ellipsoid |
<optional> |
椭球体。如果未指定，则使用WGS84椭球体。 | |
tileDiscardPolicy |
TileDiscardPolicy |
<optional> |
确定平铺
无效，应丢弃。默认情况下，DiscardEmptyTileImagePolicy
将被使用，并期望Bing地图服务器将对丢失的分片发送零长度响应。
为了确保不丢弃任何分片，请构造并传递此参数的NeverTileDiscardPolicy。 |