BingMapsImageryProvider

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

要构造 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 682

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

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

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

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

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

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

获取当影像提供者遇到异步错误时引发的事件。通过订阅该事件，您将收到错误通知并可能从中恢复。事件监听器会接收一个 TileProviderError 实例。

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

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

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

获取 Bing Maps 密钥。

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

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

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

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

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

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

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

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

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

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

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

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

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

获取瓦片丢弃策略。如果不为 undefined，该丢弃策略负责通过其 shouldDiscardImage 函数过滤掉"缺失"的瓦片。如果此函数返回 undefined，则不过滤任何瓦片。

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

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

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

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

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

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

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

获取托管影像的 BingMaps 服务器 URL 名称。

Methods

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

创建一个使用 Bing Maps Imagery REST API 提供瓦片影像的 ImageryProvider。
Name Type Description
url Resource | string 托管影像的 Bing Maps 服务器 URL。
options BingMapsImageryProvider.ConstructorOptions 描述初始化选项的对象
Returns:
一个解析为创建的 BingMapsImageryProvider 的 Promise
Throws:
  • RuntimeError : 元数据未在 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 651

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

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

将瓦片的 (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 539

获取当给定瓦片显示时要展示的版权信息。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别；
Returns:
当瓦片显示时要展示的版权信息。

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

此影像提供者当前不支持要素拾取，因此此函数仅返回 undefined。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别。
longitude number 要拾取要素的经度。
latitude number 要拾取要素的纬度。
Returns:
由于不支持拾取，返回 undefined。

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

请求给定瓦片的图像。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片级别。
request Request optional 请求对象。仅供内部使用。
Returns:
图像的 Promise，当图像可用时解析；如果对服务器的活动请求过多，则返回 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 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets