要构造 CesiumTerrainProvider,请调用
一个 ArcGISTiledElevationTerrainProvider.fromUrl。不要直接调用构造函数。
TerrainProvider,通过细分从 ArcGIS ImageService 的高程切片中检索的高度图来生成地形几何体。
| 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
获取一个可用于确定此提供程序地形可用性的对象,例如在点和矩形处。如果可用性信息不可用,此属性可能为 undefined。
readonly credit : Credit
获取此地形提供程序处于活动状态时显示的版权信息。通常用于标注地形数据的来源。
readonly errorEvent : Event
获取当地形提供程序遇到异步错误时引发的事件。通过订阅该事件,您将收到错误通知并可能从中恢复。事件监听器会接收一个
TileProviderError 实例。
获取一个值,指示请求的切片是否包含顶点法线。
获取一个值,指示提供程序是否包含水面遮罩。水面遮罩指示地球上哪些区域是水域而非陆地,以便将其渲染为带有动态波浪的反射表面。
readonly tilingScheme : GeographicTilingScheme
获取此提供程序使用的切片方案。
Methods
static Cesium.ArcGISTiledElevationTerrainProvider.fromUrl(url, options) → Promise.<ArcGISTiledElevationTerrainProvider>
创建一个
TerrainProvider,通过细分从 ArcGIS ImageService 的高程切片中检索的高度图来生成地形几何体。
| 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:
请求几何数据的 Promise。如果此方法返回 undefined 而非 Promise,则表示已有过多请求正在等待,该请求将在稍后重试。
Type Definitions
ArcGISTiledElevationTerrainProvider 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
token |
string |
<optional> |
用于连接服务的授权令牌。 | |
ellipsoid |
Ellipsoid |
<optional> |
Ellipsoid.default | 椭球体。如果指定了 tilingScheme,则忽略此参数,并使用切片方案的椭球体。如果两个参数都未指定,则使用默认椭球体。 |
