要构造一个 IonImageryProvider，请调用
提供使用 Cesium ion REST API 的平铺图像。
IonImageryProvider.fromAssetId。请勿直接调用构造函数。
| Name | Type | Description |
|---|---|---|
options |
IonImageryProvider.ConstructorOptions | optional 描述初始化选项的对象 |
Example:
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
viewer.imageryLayers.add(imageryLayer);See:
Members
readonly credit : Credit
获取在此图像提供者激活时要显示的信用信息。通常用于信用图像的来源。
readonly errorEvent : Event
获取当图像提供者遇到异步错误时引发的事件。通过订阅此事件，您将收到错误通知并可以进行潜在的恢复。
事件监听器会接收到
TileProviderError 的实例。
获取一个值，指示此图像提供者提供的图像是否包含 alpha 通道。
如果此属性为 false，则如果存在，将忽略 alpha 通道。
如果此属性为 true，则没有 alpha 通道的图像将被视为其 alpha 在所有地方都是 1.0。
当此属性为 false 时，内存使用量和纹理上传时间会减少。
获取可以请求的最大细节级别。
获取可以请求的最小细节级别。通常，
仅当图像的矩形足够小，使得最小级别的瓦片数量较小时，才应使用最小级别。
拥有超过几个瓦片的图像提供者在最小级别将导致
渲染问题。
readonly proxy : Proxy
获取此提供者使用的代理。
-
Default Value:
undefined
readonly rectangle : Rectangle
获取此实例提供的图像的矩形，单位为弧度。
readonly tileDiscardPolicy : TileDiscardPolicy
获取瓦片丢弃策略。如果未定义，丢弃策略负责
通过其 shouldDiscardImage 函数过滤掉“缺失”瓦片。如果此函数
返回未定义，则不会过滤任何瓦片。
获取每个瓦片的高度，单位为像素。
获取每个瓦片的宽度，单位为像素。
readonly tilingScheme : TilingScheme
获取提供者使用的瓦片方案。
Methods
static Cesium.IonImageryProvider.fromAssetId(assetId, options) → Promise.<IonImageryProvider>
创建一个用于使用 Cesium ion REST API 的平铺图像的提供者。
| Name | Type | Description |
|---|---|---|
assetId |
Number | 一个 ion 图像资产 ID。 |
options |
IonImageryProvider.ConstructorOptions | optional 描述初始化选项的对象。 |
Returns:
一个 Promise，解析为创建的 IonImageryProvider。
Throws:
-
RuntimeError : Cesium ion assetId 不是图像资产。
-
RuntimeError : 未识别的 Cesium ion 图像类型。
Example:
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
viewer.imageryLayers.add(imageryLayer);getTileCredits(x, y, level) → Array.<Credit>
获取在给定瓦片显示时要显示的信用信息。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别； |
Returns:
显示瓦片时要展示的信用信息。
pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
异步确定在给定经度和纬度内，瓦片上是否存在特征（如果有的话）。该函数是可选的，因此并非所有的 ImageryProviders 都会存在该函数。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
longitude |
number | 要选择特征的经度。 |
latitude |
number | 要选择特征的纬度。 |
Returns:
一个 Promise，表示选中的特征，在异步选择完成时解析。解析值是一个
ImageryLayerFeatureInfo 实例的数组。如果在给定位置未找到特征，数组可能为空。如果不支持选择，则可能返回 undefined。
requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
请求给定瓦片的图像。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片的 X 坐标。 |
y |
number | 瓦片的 Y 坐标。 |
level |
number | 瓦片级别。 |
request |
Request | optional 请求对象，仅供内部使用。 |
Returns:
一个 Promise，在图像可用时解析为图像，
或如果对服务器的活动请求过多，则返回 undefined，表示请求应稍后重试。
Type Definitions
TileMapServiceImageryProvider 构造函数的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
accessToken |
string |
<optional> |
Ion.defaultAccessToken | 要使用的访问令牌。 |
server |
string | Resource |
<optional> |
Ion.defaultServer | 指向 Cesium ion API 服务器的资源。 |