BingMapsImageryProvider

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

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

获取或设置要在署名中显示的 Bing 徽标的 URL。

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

获取在此影像提供程序处于活动状态时显示的署名。通常用于为影像来源署名。

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

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

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

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

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

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

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

获取 Bing Maps 密钥。

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

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

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

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

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

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

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

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

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

获取此提供程序使用的代理。

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

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

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

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

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

获取每个瓦片的高度（像素）。

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

获取每个瓦片的宽度（像素）。

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

获取此提供程序使用的瓦片方案。

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

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

Methods

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

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

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

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

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

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

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

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

此影像提供程序当前不支持要素拾取，因此此函数仅返回 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 546

请求给定瓦片的图像。
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。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
CtrlK
packages/engine
packages/widgets