BingMapsImageryProvider

new Cesium.BingMapsImageryProvider(options)
engine/Source/Scene/BingMapsImageryProvider.js 206

要构造BingMapsImageryProvider，请调用BingMapsImageryProvider.fromUrl。请勿直接调用构造函数。
使用Bing Maps Imagery REST API提供瓦片影像。
Name Type Description
options BingMapsImageryProvider.ConstructorOptions 描述初始化选项的对象
Example:
const bing = await Cesium.BingMapsImageryProvider.fromUrl(
  "https://dev.virtualearth.net", {
    key: "get-yours-at-https://www.bingmapsportal.com/",
    mapStyle: Cesium.BingMapsStyle.AERIAL
});
See:

Members

static Cesium.BingMapsImageryProvider.logoUrl : string
engine/Source/Scene/BingMapsImageryProvider.js 674

获取或设置用于在信用中显示的Bing logo的URL。

readonly credit : Credit
engine/Source/Scene/BingMapsImageryProvider.js 426

获取当此影像提供者处于活动状态时要显示的信用。通常用于给影像来源进行信用标注。

readonly culture : string
engine/Source/Scene/BingMapsImageryProvider.js 318

请求Bing Maps影像时使用的文化。并非所有文化都受到支持。有关支持的文化的信息，请参见http://msdn.microsoft.com/en-us/library/hh441729.aspx。

readonly errorEvent : Event
engine/Source/Scene/BingMapsImageryProvider.js 414

获取当影像提供者遇到异步错误时引发的事件。通过订阅此事件，您将被通知错误并可以进行潜在的恢复。事件监听器将传递一个TileProviderError的实例。

readonly hasAlphaChannel : boolean
engine/Source/Scene/BingMapsImageryProvider.js 438

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

readonly key : string
engine/Source/Scene/BingMapsImageryProvider.js 282

获取Bing Maps密钥。

readonly mapLayer : string
engine/Source/Scene/BingMapsImageryProvider.js 306

获取根据https://learn.microsoft.com/en-us/bingmaps/rest-services/imagery/get-imagery-metadata#template-parameters定义的附加地图层选项。

readonly mapStyle : BingMapsStyle
engine/Source/Scene/BingMapsImageryProvider.js 294

获取要加载的Bing Maps影像类型。

readonly maximumLevel : number|undefined
engine/Source/Scene/BingMapsImageryProvider.js 354

获取可以请求的最大细节级别。

readonly minimumLevel : number
engine/Source/Scene/BingMapsImageryProvider.js 366

获取可以请求的最小细节级别。

readonly proxy : Proxy
engine/Source/Scene/BingMapsImageryProvider.js 270

获取该提供者使用的代理。

readonly rectangle : Rectangle
engine/Source/Scene/BingMapsImageryProvider.js 390

获取此实例提供的影像的矩形范围（以弧度为单位）。

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/BingMapsImageryProvider.js 402

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

readonly tileHeight : number
engine/Source/Scene/BingMapsImageryProvider.js 342

获取每个切片的高度（以像素为单位）。

readonly tileWidth : number
engine/Source/Scene/BingMapsImageryProvider.js 330

获取每个切片的宽度（以像素为单位）。

readonly tilingScheme : TilingScheme
engine/Source/Scene/BingMapsImageryProvider.js 378

获取该提供者使用的切片方案。

readonly url : string
engine/Source/Scene/BingMapsImageryProvider.js 258

获取承载影像的BingMaps服务器URL的名称。

Methods

static Cesium.BingMapsImageryProvider.fromUrl(url, options) → Promise.<BingMapsImageryProvider>
engine/Source/Scene/BingMapsImageryProvider.js 462

创建一个ImageryProvider，该提供者使用Bing Maps Imagery REST API提供瓦片影像。
Name Type Description
url Resource | String 承载影像的Bing Maps服务器的URL。
options BingMapsImageryProvider.ConstructorOptions 描述初始化选项的对象
Returns:
一个承诺，解析为创建的BingMapsImageryProvider
Throws:
  • RuntimeError : metadata does not specify one resource in resourceSets
Example:
const bing = await Cesium.BingMapsImageryProvider.fromUrl(
  "https://dev.virtualearth.net", {
    key: "get-yours-at-https://www.bingmapsportal.com/",
    mapStyle: Cesium.BingMapsStyle.AERIAL
});

static Cesium.BingMapsImageryProvider.quadKeyToTileXY(quadkey)
engine/Source/Scene/BingMapsImageryProvider.js 643

将用于从Bing Maps服务器请求图像的切片四键（quadkey）转换为 (x, y, level)位置。
Name Type Description
quadkey string 切片的四键
See:

static Cesium.BingMapsImageryProvider.tileXYToQuadKey(x, y, level)
engine/Source/Scene/BingMapsImageryProvider.js 614

将切片的(x, y, level)位置转换为用于从Bing Maps服务器请求图像的四键（quadkey）。
Name Type Description
x number 切片的X坐标。
y number 切片的Y坐标。
level number 切片的缩放级别。
See:

getTileCredits(x, y, level) → Array.<Credit>
engine/Source/Scene/BingMapsImageryProvider.js 529

获取在显示给定切片时要展示的信用。
Name Type Description
x number 切片的X坐标。
y number 切片的Y坐标。
level number 切片级别；
Returns:
在切片显示时要展示的信用。

pickFeatures(x, y, level, longitude, latitude) → undefined
engine/Source/Scene/BingMapsImageryProvider.js 593

该影像提供者目前不支持特征选择，因此该函数仅返回 未定义。
Name Type Description
x number 切片的X坐标。
y number 切片的Y坐标。
level number 切片级别。
longitude number 要选择特征的经度。
latitude number 要选择特征的纬度。
Returns:
因为不支持选择，所以返回未定义。

requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
engine/Source/Scene/BingMapsImageryProvider.js 555

请求给定切片的图像。
Name Type Description
x number 切片的X坐标。
y number 切片的Y坐标。
level number 切片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
一个承诺，表示图像将在可用时解析，如果对服务器的活动请求过多，则返回undefined，表示请求应稍后重试。

Type Definitions

Cesium.BingMapsImageryProvider.ConstructorOptions
engine/Source/Scene/BingMapsImageryProvider.js 17

BingMapsImageryProvider构造函数的初始化选项
Properties:
Name Type Attributes Default Description
key string <optional>
 应用程序的Bing Maps密钥，可以在https://www.bingmapsportal.com/创建。
tileProtocol string <optional>
 加载切片时使用的协议，例如'http'或'https'。 默认情况下，切片使用与页面相同的协议加载。
mapStyle BingMapsStyle <optional>
 BingMapsStyle.AERIAL 要加载的Bing Maps影像类型。
mapLayer string <optional>
 附加显示层选项，如https://learn.microsoft.com/en-us/bingmaps/rest-services/imagery/get-imagery-metadata#template-parameters所定义。
culture string <optional>
 '' 请求Bing Maps影像时使用的文化。并非所有文化都受到支持。有关支持的文化的信息，请参见http://msdn.microsoft.com/en-us/library/hh441729.aspx。
ellipsoid Ellipsoid <optional>
 Ellipsoid.default 椭球。如果未指定，将使用默认的椭球。
tileDiscardPolicy TileDiscardPolicy <optional>
 决定切片是否无效并应该被丢弃的策略。默认情况下，将使用DiscardEmptyTileImagePolicy，预计Bing Maps服务器会对缺失的切片返回零长度响应。 若要确保没有切片被丢弃，请为此参数构造并传递NeverTileDiscardPolicy。
需要帮助？获得答案的最快方法是来自社区和团队 Cesium Forum.
packages/engine
packages/widgets