new Cesium.IonImageryProvider(options)
使用Cesium ion REST API提供瓦片图像。
| Name | Type | Description | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
此对象拥有以下属性：
|
示例：
viewer.imageryLayers.addImageryProvider(new Cesium.IonImageryProvider({ assetId : 23489024 }));成员变量
获取版权信息。 在
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
defaultMagnificationFilter : TextureMagnificationFilter
应用于该提供器的默认纹理放大滤镜。
-
Default Value:
undefined
defaultMinificationFilter : TextureMinificationFilter
应用于该提供器的默认纹理缩小过滤器。
-
Default Value:
undefined
defaultSaturation : Number
此提供器的默认饱和度。1.0使用未修改的图像颜色。小于1.0会降低饱和度，而大于1.0则会增加饱和度。
-
Default Value:
undefined
获取此提供器遇到异步错误时触发的事件。
通过订阅事件，您将收到错误通知，并可能从中恢复。事件监听器传递一个
TileProviderError的实例。
获取影像是否有Alpha通道。
获取最大级别。在
IonImageryProvider#ready返回true之前，不应调用此函数。
获取可以请求的最小级别。 在
IonImageryProvider#ready返回true之前，不应调用此函数。
通常，只有当图像的矩形足够小，使得最小级别的瓦片数量足够少时，才应该使用最小级别。
一个图像提供器如果在最小级别上有多个图像瓦片，就会导致渲染问题。
获取此提供器是否已经准备好。
获取一个在提供器准备就绪时可以解析为true的Promise。
获取地图矩形范围（以弧度表示）。 在
IonImageryProvider#ready返回true之前，不应调用此函数。
获取瓦片忽略策略。如果未定义，则忽略策略负责通过其shouldDiscardImage函数过滤掉“丢失”的瓦片。
如果此函数返回未定义，则不过滤任何切片。 在
IonImageryProvider#ready返回true之前，不应调用此函数。
获取瓦片高，以像素为单位。在
IonImageryProvider#ready返回true之前，不应调用此函数。
获取瓦片宽，以像素为单位。在
IonImageryProvider#ready返回true之前，不应调用此函数。
获取瓦片切片方案。在
IonImageryProvider#ready返回true之前，不应调用此函数。
内置方法
获取当请求的瓦片被显示出来时，要显示的版权信息。
| Name | Type | Description |
|---|---|---|
x |
Number | 瓦片的X坐标。 |
y |
Number | 瓦片的Y坐标。 |
level |
Number | 瓦片的层级。 |
返回值：
返回的版权。
异常情况：
-
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 | 拾取要素的纬度。 |
返回值：
对所选要素的promise，它将在异步拾取完成时解析。
解析后的值是
ImageryLayerFeatureInfo实例的数组。如果在给定位置没有发现任何要素，则该数组可能为空。
如果不支持拾取，它也可能是未定义的。
异常情况：
-
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对象（仅供内部使用）。 |
返回值：
返回值有以下3种情况：
1.当图像可用时，返回对图像的Promise。
2.如果有太多对服务器的活动请求，则返回未定义图像，并且应该稍后重新请求。
3.解析后的图像可以是图像，也可以是画布DOM对象。
异常情况：
-
DeveloperError : 准备好图像提供器之前，不得调用
requestImage。
