BingMapsImageryProvider

new Cesium.BingMapsImageryProvider (options)

使用Bing Maps Imagery REST API提供平铺的图像。
Name Type Description
options Object 具有以下属性的对象:
名称 类型 默认 说明
url 资源 | 字符串 托管图像的Bing Maps服务器的网址。
key 字符串 可选 您的应用程序的Bing Maps密钥,可以是       在 https://www.bingmapsportal.com/ 中创建。       如果未提供此参数,则使用 BingMapsApi.defaultKey ,默认情况下未定义。
tileProtocol 字符串 可选 加载图块时使用的协议,例如' http'或' https'。       默认情况下,使用与页面相同的协议加载图块。
mapStyle BingMapsStyle BingMapsStyle.AERIAL 可选 要加载的必应地图图像的类型。
文化 字符串 '' 可选 请求必应地图图像时要使用的区域性。不       支持所有文化。请参阅 http://msdn.microsoft.com/en-us/library/hh441729.aspx 了解有关支持的文化的信息。
椭球 椭球 可选 椭球。如果未指定,则使用WGS84椭球。
tileDiscardPolicy TileDiscardPolicy 可选 确定磁贴是否存在的策略       无效,应将其丢弃。默认情况下, DiscardEmptyTileImagePolicy 将使用Bing Maps服务器,期望它为丢失的图块发送零长度响应。       为确保不丢弃任何切片,请为此参数构造并传递 NeverTileDiscardPolicy
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

static Cesium.BingMapsImageryProvider.logoUrl : String

获取或设置Bing徽标的URL,以在积分中显示。
获取此图像提供者处于活动状态时要显示的功劳。通常,这用于记入图像的来源。在 BingMapsImageryProvider#ready 返回true之前,不应调用此函数。
请求必应地图图像时要使用的区域性。不支持所有文化。请参阅 http://msdn.microsoft.com/en-us/library/hh441729.aspx 有关支持的文化的信息。
默认的 ImageryLayer#gamma 用于为此提供商创建的图像图层。为此提供程序创建 ImageryLayer 后更改此值将具有没有效果。而是设置图层的 ImageryLayer#gamma 属性。
Default Value: 1.0
获取当图像提供程序遇到异步错误时引发的事件。通过订阅事件发生后,您将收到有关该错误的通知,并有可能从中恢复。事件监听器传递了 TileProviderError 的实例。

readonly hasAlphaChannel : Boolean

获取一个值,该值指示此图像提供者是否提供了图像包括一个Alpha通道。如果此属性为false,则Alpha通道(如果存在)将被忽略。如果此属性为true,则将处理没有alpha通道的任何图像好像他们的alpha到处都是1.0。将此属性设置为false可减少内存使用量和纹理上传时间。
获取'必应地图'键。
获取要加载的'必应地图'图像的类型。

readonly maximumLevel : Number

获取可以请求的最大详细程度。该功能应在 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服务器网址的名称。

Methods

static Cesium.BingMapsImageryProvider.quadKeyToTileXY (quadkey)

将用于从Bing Maps服务器请求图像的图块的四键转换为(x,y,水平)位置。
Name Type Description
quadkey String 磁贴的四键键
See:

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

将图块(x,y,水平)位置转换为用于请求图像的四键从Bing Maps服务器。
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) Promise.<Array.< ImageryLayerFeatureInfo >>|undefined

该图像提供者当前不支持拾取功能,因此该函数仅返回未定义。
Name Type Description
x Number 瓦片X坐标。
y Number 瓷砖的Y坐标。
level Number 平铺级别。
longitude Number 选择要素的经度。
latitude Number 选择要素的纬度。
Returns:
对所选择功能的承诺将在异步时解决                  采摘完成。解析的值是一个数组 ImageryLayerFeatureInfo 实例。如果在给定位置找不到要素,则数组可能为空。                  如果不支持拣配,则它也可能是未定义的。

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

请求给定图块的图像。该功能应在 BingMapsImageryProvider#ready 返回true之前不会被调用。
Name Type Description
x Number 瓦片X坐标。
y Number 瓷砖的Y坐标。
level Number 平铺级别。
request Request 可选 请求对象。仅供内部使用。
Returns:
对图像的承诺,将在图像可用时解决,或者         如果对服务器的活动请求过多,并且请求过多,则不确定         应稍后重试。解析的图像可能是         图片或Canvas DOM对象。
Throws:
  • DeveloperError : requestImage 影像提供者准备就绪之前,不得调用它。