要构造一个 CesiumTerrainProvider，请调用 To construct a CesiumTerrainProvider, call
A ArcGISTiledElevationTerrainProvider.fromUrl。不要直接调用构造函数。 . Do not call the constructor directly.
TerrainProvider 通过细分从 ArcGIS ImageService 的高程图块检索的高度图来生成地形几何图形。 that produces terrain geometry by tessellating height maps retrieved from Elevation Tiles of an an ArcGIS ImageService.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
options |
CesiumTerrainProvider.ConstructorOptions | 可选 optional 描述初始化选项的 url 或对象 A url or an object describing initialization options |
示例： 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
获取一个对象，该对象可用于确定此提供者提供的地形的可用性，例如点和矩形中的地形。如果可用性信息不可用，则此属性可能未定义。 Gets an object that can be used to determine availability of terrain from this provider, such as at points and in rectangles. This property may be undefined if availability information is not available.
readonly credit : Credit
获取此地形提供程序处于活动状态时要显示的积分。通常，这用于证明地形的来源。 Gets the credit to display when this terrain provider is active. Typically this is used to credit the source of the terrain.
readonly errorEvent : Event
获取当地形提供程序遇到异步错误时引发的事件。通过订阅该事件，您将收到错误通知，并有可能从中恢复。事件监听器传递一个实例 Gets an event that is raised when the terrain provider encounters an asynchronous error. By subscribing to the event, you will be notified of the error and can potentially recover from it. Event listeners are passed an instance of
TileProviderError.
获取一个值，该值指示请求的切片是否包含顶点法线。 Gets a value indicating whether or not the requested tiles include vertex normals.
获取一个值，该值指示提供程序是否包含水罩。水掩模指示地球的哪些区域是水而不是陆地，因此可以将它们渲染为带有动画波浪的反射表面。 Gets a value indicating whether or not the provider includes a water mask. The water mask indicates which areas of the globe are water rather than land, so they can be rendered as a reflective surface with animated waves.
readonly tilingScheme : GeographicTilingScheme
获取此提供程序使用的切片方案。 Gets the tiling scheme used by this provider.
方法 Methods
static Cesium.ArcGISTiledElevationTerrainProvider.fromUrl(url, options) → Promise.<ArcGISTiledElevationTerrainProvider>
创建一个 Creates a
TerrainProvider 通过细分从 ArcGIS ImageService 的高程图块检索的高度图来生成地形几何图形。 that produces terrain geometry by tessellating height maps retrieved from Elevation Tiles of an an ArcGIS ImageService.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
url |
Resource | string | Promise.<Resource> | Promise.<string> | ArcGIS ImageServer 服务的 URL。 The URL of the ArcGIS ImageServer service. |
options |
ArcGISTiledElevationTerrainProvider.ConstructorOptions | 可选 optional 描述初始化选项的 url 或对象。 A url or an object describing initialization options. |
返回： Returns:
抛出： Throws:
-
RuntimeError ：元数据指定无效的空间参考 : metadata specifies invalid spatial reference
-
RuntimeError : 元数据未指定tileInfo : metadata does not specify tileInfo
示例： Example:
const terrainProvider = await Cesium.ArcGISTiledElevationTerrainProvider.fromUrl("https://elevation3d.arcgis.com/arcgis/rest/services/WorldElevation3D/Terrain3D/ImageServer", {
token: "KED1aF_I4UzXOHy3BnhwyBHU4l5oY6rO6walkmHoYqGp4XyIWUd5YZUC1ZrLAzvV40pR6gBXQayh0eFA8m6vPg.."
});
viewer.terrainProvider = terrainProvider;
获取给定级别的图块中允许的最大几何误差。 Gets the maximum geometric error allowed in a tile at a given level.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
level |
number | 获得最大几何误差的图块级别。 The tile level for which to get the maximum geometric error. |
返回： Returns:
最大几何误差。 The maximum geometric error.
确定图块的数据是否可供加载。 Determines whether data for a tile is available to be loaded.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
返回： Returns:
如果不支持则未定义，否则 true 或 false。 Undefined if not supported, otherwise true or false.
确保我们加载图块的可用性数据 Makes sure we load availability data for a tile
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
返回： Returns:
该提供商不支持加载可用性。 This provider does not support loading availability.
requestTileGeometry(x, y, level, request) → Promise.<TerrainData>|undefined
请求给定图块的几何形状。结果包括地形数据并指示所有子图块均可用。 Requests the geometry for a given tile. The result includes terrain data and indicates that all child tiles are available.
| 名称 Name | 类型 Type | 说明 Description |
|---|---|---|
x |
number | 请求几何图形的图块的 X 坐标。 The X coordinate of the tile for which to request geometry. |
y |
number | 请求几何图形的图块的 Y 坐标。 The Y coordinate of the tile for which to request geometry. |
level |
number | 请求几何图形的图块的级别。 The level of the tile for which to request geometry. |
request |
Request | 可选 optional 请求对象。仅供内部使用。 The request object. Intended for internal use only. |
返回： Returns:
对所要求的几何形状的承诺。如果此方法返回未定义而不是承诺，则表明已有太多请求处于待处理状态，稍后将重试该请求。 A promise for the requested geometry. If this method returns undefined instead of a promise, it is an indication that too many requests are already pending and the request will be retried later.
类型定义 Type Definitions
ArcGISTiledElevationTerrainProvider 构造函数的初始化选项 Initialization options for the ArcGISTiledElevationTerrainProvider constructor
属性： Properties:
| 名称 Name | 类型 Type | Attributes | 默认值 Default | 说明 Description |
|---|---|---|---|---|
token |
string |
<可选> <optional> |
用于连接到服务的授权令牌。 The authorization token to use to connect to the service. | |
ellipsoid |
Ellipsoid |
<可选> <optional> |
Ellipsoid.default | 椭球体。如果指定了 tilingScheme，则忽略此参数并使用切片方案的椭球体。如果两个参数均未指定，则使用默认椭球体。 The ellipsoid. If the tilingScheme is specified, this parameter is ignored and the tiling scheme's ellipsoid is used instead. If neither parameter is specified, the default ellipsoid is used. |