IonImageryProvider

new Cesium.IonImageryProvider(options)

使用Cesium ion REST API提供瓦片图像。
Name Type Description
options Object 此对象拥有以下属性:
Name Type Default Description
assetId Number ion影像asset ID。
accessToken String Ion.defaultAccessToken optional 要使用的访问令牌。
server String | Resource Ion.defaultServer optional Cesium ion API服务器的资源。
Example:
viewer.imageryLayers.addImageryProvider(new Cesium.IonImageryProvider({ assetId : 23489024 }));

Members

获取版权信息。 在IonImageryProvider#ready返回true之前,不应调用此函数。

defaultAlpha : Number

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

defaultBrightness : Number

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

defaultContrast : Number

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

defaultGamma : Number

适用于此提供器的默认伽玛校正。1.0使用未修改的图像颜色。
Default Value: undefined

defaultHue : Number

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

defaultSaturation : Number

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

readonlyerrorEvent : Event

获取此提供器遇到异步错误时触发的事件。 通过订阅事件,您将收到错误通知,并可能从中恢复。事件监听器传递一个TileProviderError的实例。

readonlyhasAlphaChannel : Boolean

获取影像是否有Alpha通道。

readonlymaximumLevel : Number

获取最大级别。在IonImageryProvider#ready返回true之前,不应调用此函数。

readonlyminimumLevel : Number

获取可以请求的最小级别。 在IonImageryProvider#ready返回true之前,不应调用此函数。 通常,只有当图像的矩形足够小,使得最小级别的瓦片数量足够少时,才应该使用最小级别。 一个图像提供器如果在最小级别上有多个图像瓦片,就会导致渲染问题。

readonlyready : Boolean

获取此提供器是否已经准备好。

readonlyreadyPromise : Promise.<Boolean>

获取一个在提供器准备就绪时可以解析为true的Promise。
获取地图矩形范围(以弧度表示)。 在IonImageryProvider#ready返回true之前,不应调用此函数。
获取瓦片忽略策略。如果未定义,则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。 如果此函数返回未定义,则不过滤任何切片。 在IonImageryProvider#ready返回true之前,不应调用此函数。

readonlytileHeight : Number

获取瓦片高,以像素为单位。在IonImageryProvider#ready返回true之前,不应调用此函数。

readonlytileWidth : Number

获取瓦片宽,以像素为单位。在IonImageryProvider#ready返回true之前,不应调用此函数。
获取瓦片切片方案。在IonImageryProvider#ready返回true之前,不应调用此函数。

Methods

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

异步地确定哪些要素(如果有的话)位于瓦片中给定的经度和纬度。 在IonImageryProvider#ready返回true之前,不应该调用此函数。 这个函数是可选的,所以它可能不存在于所有的ImageryProviders上。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的级别。
longitude Number 拾取要素的经度。
latitude Number 拾取要素的纬度。
Returns:
对所选要素的promise,它将在异步拾取完成时解析。 解析后的值是ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素,则该数组可能为空。 如果不支持拾取,它也可能是未定义的。
Throws:
  • DeveloperError : pickFeatures在图像提供器准备好之前不能被调用。

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

请求给定块的瓦片。在GoogleEarthEnterpriseMapsProvider#ready返回true之前,不应调用此函数。
Name Type Description
x Number 瓦片的X坐标。
y Number 瓦片的Y坐标。
level Number 瓦片的层级。
request Request optional Request对象(仅供内部使用)。
Returns:
返回值有以下3种情况: 1.当图像可用时,返回对图像的Promise。 2.如果有太多对服务器的活动请求,则返回未定义图像,并且应该稍后重新请求。 3.解析后的图像可以是图像,也可以是画布DOM对象。
Throws:
  • DeveloperError : 准备好图像提供器之前,不得调用 requestImage