BingMapsImageryProvider

new Cesium.BingMapsImageryProvider (options)

使用 Bing Maps Imagery REST API 提供平铺图像。
Name Type Description
options BingMapsImageryProvider.ConstructorOptions 描述初始化选项的对象
Example:
const bing = new Cesium.BingMapsImageryProvider({
    url : 'https://dev.virtualearth.net',
    key : 'get-yours-at-https://www.bingmapsportal.com/',
    mapStyle : Cesium.BingMapsStyle.AERIAL
});
See:

Members

static Cesium.BingMapsImageryProvider.logoUrl : String

获取或设置 Bing 徽标的 URL,以在致谢中显示。
当此图像提供程序处于活动状态时,获得要显示的功劳。通常,这用于说明图像的来源。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
请求 Bing 地图图像时使用的文化。并非所有文化都受支持。有关支持的文化的信息,请参阅 http://msdn.microsoft.com/en-us/library/hh441729.aspx

defaultAlpha : Number|undefined

此提供程序的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
Default Value: undefined

defaultBrightness : Number|undefined

此提供程序的默认亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像更暗,而大于 1.0 会使图像更亮。
Default Value: undefined

defaultContrast : Number|undefined

此提供程序的默认对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度,而大于 1.0 会增加对比度。
Default Value: undefined

defaultDayAlpha : Number|undefined

此提供程序的地球日侧的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
Default Value: undefined

defaultGamma : Number|undefined

应用于此提供程序的默认伽马校正。 1.0 使用未修改的图像颜色。
Default Value: 1.0

defaultHue : Number|undefined

此提供程序的默认色调(以弧度为单位)。 0.0 使用未修改的图像颜色。
Default Value: undefined
应用于此提供程序的默认纹理放大过滤器。
Default Value: undefined
应用于此提供程序的默认纹理缩小过滤器。
Default Value: undefined

defaultNightAlpha : Number|undefined

此提供程序的地球夜晚的默认 alpha 混合值,0.0 表示完全透明,1.0 表示完全不透明。
Default Value: undefined

defaultSaturation : Number|undefined

此提供程序的默认饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度,而大于 1.0 会增加饱和度。
Default Value: undefined
获取图像提供程序遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知,并有可能从中恢复。事件侦听器被传递一个 TileProviderError 实例。

readonly hasAlphaChannel : Boolean

获取一个值,该值指示此图像提供程序提供的图像是否包含 Alpha 通道。如果此属性为 false,则 Alpha 通道(如果存在)将被忽略。如果此属性为真,则任何没有 alpha 通道的图像都将被视为其 alpha 在任何地方都是 1.0。将此属性设置为 false 可减少内存使用和纹理上传时间。
获取 Bing 地图键。
获取要加载的 Bing 地图图像的类型。

readonly maximumLevel : Number|undefined

获取可以请求的最大细节级别。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。

readonly minimumLevel : Number

获取可以请求的最低详细级别。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
获取此提供程序使用的代理。
获取一个值,该值指示提供程序是否已准备好使用。

readonly readyPromise : Promise.<Boolean>

当提供者准备好使用时,获取一个解析为 true 的承诺。
获取此实例提供的图像的矩形(以弧度为单位)。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
获取瓦片丢弃策略。如果未定义,丢弃策略负责通过其 shouldDiscardImage 函数过滤掉'丢失的'图块。如果此函数返回未定义,则不过滤任何图块。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。

readonly tileHeight : Number

获取每个图块的高度,以像素为单位。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。

readonly tileWidth : Number

获取每个图块的宽度,以像素为单位。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
获取此提供程序使用的切片方案。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
获取托管图像的 BingMaps 服务器 url 的名称。

Methods

static Cesium.BingMapsImageryProvider.quadKeyToTileXY (quadkey)

将用于从 Bing 地图服务器请求图像的图块的四键转换为 (x, y, level) 位置。
Name Type Description
quadkey String 瓷砖的四键
See:

static Cesium.BingMapsImageryProvider.tileXYToQuadKey (x, y, level)

将图块(x、y、级别)位置转换为用于从 Bing 地图服务器请求图像的四键。
Name Type Description
x Number 瓦片的 x 坐标。
y Number 瓦片的 y 坐标。
level Number 磁贴的缩放级别。
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) undefined

此图像提供程序当前不支持选择要素,因此此函数仅返回未定义。
Name Type Description
x Number 平铺 X 坐标。
y Number 瓦片 Y 坐标。
level Number 瓷砖级别。
longitude Number 选择要素的经度。
latitude Number 选择要素的纬度。
Returns:
未定义,因为不支持拾取。

requestImage (x, y, level, request ) Promise.< ImageryTypes >|undefined

请求给定图块的图像。在 BingMapsImageryProvider#ready 返回 true 之前,不应调用此函数。
Name Type Description
x Number 平铺 X 坐标。
y Number 瓦片 Y 坐标。
level Number 瓷砖级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺,当图像可用时将解析,或者如果对服务器的活动请求过多,则未定义,并且应稍后重试请求。
Throws:
  • DeveloperError :在图像提供程序准备好之前,不得调用 requestImage

Type Definitions

Cesium.BingMapsImageryProvider.ConstructorOptions

BingMapsImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url Resource | String 托管图像的 Bing 地图服务器的 url。
key String 应用程序的 Bing 地图密钥,可在 https://www.bingmapsportal.com/ 创建。
tileProtocol String <optional>
加载图块时使用的协议,例如'http'或'https'。默认情况下,tile 使用与页面相同的协议加载。
mapStyle BingMapsStyle <optional>
BingMapsStyle.AERIAL 要加载的 Bing 地图图像的类型。
culture String <optional>
'' 请求 Bing 地图图像时使用的文化。并非所有文化都受支持。有关支持的文化的信息,请参阅 http://msdn.microsoft.com/en-us/library/hh441729.aspx
ellipsoid Ellipsoid <optional>
椭球体。如果未指定,则使用 WGS84 椭球。
tileDiscardPolicy TileDiscardPolicy <optional>
确定图块是否无效并应丢弃的策略。默认情况下,将使用 DiscardEmptyTileImagePolicy ,并期望 Bing 地图服务器将为丢失的图块发送零长度响应。为确保不丢弃任何切片,请为此参数构造并传递 NeverTileDiscardPolicy