要构造一个 CesiumTerrainProvider,请调用
一个 ArcGISTiledElevationTerrainProvider.fromUrl。请勿直接调用构造函数。
TerrainProvider,通过从 ArcGIS 图像服务的高程切片获取的高度图进行镶嵌,产生地形几何体。
| Name | Type | Description |
|---|---|---|
options |
CesiumTerrainProvider.ConstructorOptions | optional 一个 URL 或描述初始化选项的对象 |
Example:
const terrainProvider = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer", {
token: "KED1aF_I4UzXOHy3BnhwyBHU4l5oY6rO6walkmHoYqGp4XyIWUd5YZUC1ZrLAzvV40pR6gBXQayh0eFA8m6vPg.."
});
viewer.terrainProvider = terrainProvider;
See:
Members
readonly availability : TileAvailability
获取一个对象,可以用来确定从该提供者获取地形的可用性,比如
在点和矩形中。如果可用性信息不可用,则该属性可能为 undefined。
readonly credit : Credit
获取当该地形提供者处于活动状态时显示的信用。通常用于信任地形的来源。
readonly errorEvent : Event
获取一个事件,当地形提供者遇到异步错误时会引发此事件。通过订阅该事件,您将被通知错误,并可能从中恢复。事件监听器
会传递给一个
TileProviderError 实例。
获取一个值,指示请求的切片是否包括顶点法线。
获取一个值,指示提供者是否包括水面遮罩。水面遮罩
指示地球上的哪些区域是水而不是陆地,以便可以将它们渲染为具有动态波浪的反射表面。
readonly tilingScheme : GeographicTilingScheme
获取此提供者使用的切片方案。
Methods
static Cesium.ArcGISTiledElevationTerrainProvider.fromUrl(url, options) → Promise.<ArcGISTiledElevationTerrainProvider>
创建一个
TerrainProvider,通过从 ArcGIS 图像服务的高程切片获取的高度图进行镶嵌,产生地形几何体。
| Name | Type | Description |
|---|---|---|
url |
Resource | String | Promise.<Resource> | Promise.<String> | ArcGIS ImageServer 服务的 URL。 |
options |
ArcGISTiledElevationTerrainProvider.ConstructorOptions | optional 一个 URL 或描述初始化选项的对象。 |
Returns:
Throws:
-
RuntimeError : 元数据指定了无效的空间参考
-
RuntimeError : 元数据未指定 tileInfo
Example:
const terrainProvider = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer", {
token: "KED1aF_I4UzXOHy3BnhwyBHU4l5oY6rO6walkmHoYqGp4XyIWUd5YZUC1ZrLAzvV40pR6gBXQayh0eFA8m6vPg.."
});
viewer.terrainProvider = terrainProvider;
获取在给定级别的切片中允许的最大几何错误。
| Name | Type | Description |
|---|---|---|
level |
number | 要获取最大几何错误的切片级别。 |
Returns:
最大几何错误。
确定切片的数据是否可以被加载。
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的切片的 X 坐标。 |
y |
number | 请求几何体的切片的 Y 坐标。 |
level |
number | 请求几何体的切片的级别。 |
Returns:
如果不支持则为 undefined, 否则为 true 或 false。
确保我们加载切片的可用性数据。
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的切片的 X 坐标。 |
y |
number | 请求几何体的切片的 Y 坐标。 |
level |
number | 请求几何体的切片的级别。 |
Returns:
该提供者不支持加载可用性。
requestTileGeometry(x, y, level, request) → Promise.<TerrainData>|undefined
请求给定切片的几何体。结果包括地形
数据并指示所有子切片都可用。
| Name | Type | Description |
|---|---|---|
x |
number | 请求几何体的切片的 X 坐标。 |
y |
number | 请求几何体的切片的 Y 坐标。 |
level |
number | 请求几何体的切片的级别。 |
request |
Request | optional 请求对象。仅供内部使用。 |
Returns:
一个对请求的几何体的承诺。如果此方法
返回 undefined 而不是承诺,表明已经有太多请求正在等待,
并且请求将稍后重试。
Type Definitions
ArcGISTiledElevationTerrainProvider 构造函数的初始化选项。
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
token |
string |
<optional> |
用于连接到服务的授权令牌。 | |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果指定了 tilingScheme, 则此参数将被忽略,改为使用切片方案的椭球体。 如果两个参数都未指定,则使用默认椭球体。 |
