要构造 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 函数过滤掉"缺失"的瓦片。如果该函数
返回 undefined，则不会过滤任何瓦片。
获取每个瓦片的高度（以像素为单位）。
获取每个瓦片的宽度（以像素为单位）。
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:
一个解析为已创建的 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
异步确定瓦片内给定经度和纬度位置存在哪些要素（如果有）。
此函数是可选的，因此并非所有 ImageryProvider 上都存在。
| Name | Type | Description |
|---|---|---|
x |
number | 瓦片 X 坐标。 |
y |
number | 瓦片 Y 坐标。 |
level |
number | 瓦片级别。 |
longitude |
number | 拾取要素的经度。 |
latitude |
number | 拾取要素的纬度。 |
Returns:
拾取要素的承诺，当异步
拾取完成时解析。解析值是一个
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:
图像的承诺，当图像可用时解析，或者
如果服务器有太多活动请求而返回 undefined，则应稍后重试请求。
Type Definitions
TileMapServiceImageryProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
accessToken |
string |
<optional> |
Ion.defaultAccessToken | 要使用的访问令牌。 |
server |
string | Resource |
<optional> |
Ion.defaultServer | Cesium ion API 服务器的资源。 |