Cesium3DTilesTerrainProvider
Cesium v1.147 · 中文

new Cesium.Cesium3DTilesTerrainProvider(options)

要创建Cesium3DTilesTerrainProvider,请调用 Cesium3DTilesTerrainProvider.fromIonAssetId 或 Cesium3DTilesTerrainProvider.fromUrl。不要直接调用构造器。
一个访问3D瓦片格式地形数据的 TerrainProvider。
Name Type Description
options Cesium3DTilesTerrainProvider.ConstructorOptions optional 描述初始化选项的对象
Experimental

This 该功能尚未最终确定,可能会根据Cesium的标准弃用政策进行变更。

See:
  • TerrainProvider
  • Cesium3DTilesTerrainProvider.fromUrl
  • Cesium3DTilesTerrainProvider.fromIonAssetId // 使用顶点法线创建GTOPO30 try { const viewer = new Cesium.Viewer("cesiumContainer", { terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, { requestVertexNormals: true }) }); } catch (error) { console.log(error); }

Members

获取可用于确定此提供程序所提供地形可用性的对象,例如 在点和矩形上。
获取当前地形提供程序激活时显示的信用值。通常用于显示地形的来源。 获取提供程序使用的镶嵌方案。
在地形提供程序遇到异步错误时触发事件。通过订阅该事件,您将收到错误通知并可能从中恢复。事件监听器 接收 TileProviderError 的实例。 are passed an instance of TileProviderError.
获取指示请求的瓦片是否包含顶点法线的值。
获取指示提供程序是否包含水掩膜的值。水掩膜 指示地球上的哪些区域是水而不是陆地,因此可以被渲染为具有动画波浪的反射表面。 获取指示请求的瓦片是否包含顶点法线的值。
获取提供程序使用的镶嵌方案。

Methods

static Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(assetId, options) → Promise.<CesiumTerrainProvider>

从Cesium离子资产ID创建一个访问Cesium 3D瓦片格式地形数据的 TerrainProvider
Name Type Description
assetId number Cesium离子资产ID。
options CesiumTerrainProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
Throws:
  • RuntimeError : layer.json 未指定格式
  • RuntimeError : layer.json 指定了未知格式
  • RuntimeError : layer.json 指定了不支持的量化网格版本
  • RuntimeError : layer.json 未指定 tiles 属性,或指定了空数组
  • RuntimeError : layer.json 未指定任何 tile URL 模板
Example:
// 使用顶点法线创建GTOPO30
try {
const viewer = new Cesium.Viewer("cesiumContainer", {
terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, {
requestVertexNormals: true
    })
  });
} catch (error) {
console.log(error);
}

static Cesium.Cesium3DTilesTerrainProvider.fromUrl(url, options) → Promise.<Cesium3DTilesTerrainProvider>

创建一个访问Cesium 3D瓦片格式地形数据的 TerrainProvider。
Name Type Description
url Resource | string | Promise.<Resource> | Promise.<string> Cesium地形服务器的URL。
options Cesium3DTilesTerrainProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
A 解析为地形提供器的promise。
Example:
// 使用法线创建地形。
try {
const viewer = new Cesium.Viewer("cesiumContainer", {
terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromUrl(
Cesium.IonResource.fromAssetId(3956), {
requestVertexNormals: true
    })
  });
} catch (error) {
console.log(error);
}

getLevelMaximumGeometricError(level) → number

获取给定层级下瓦片允许的最大几何误差。
Name Type Description
level number 获取最大几何误差的瓦片层级。
Returns:
The 最大几何误差。

getTileDataAvailable(x, y, level) → boolean|undefined

确定特定 tiles 的数据是否可加载
Name Type Description
x number 请求几何数据的 tiles 的 X 坐标
y number 请求几何数据的 tiles 的 Y 坐标
level number 请求几何数据的 tiles 的层级
Returns:
Undefined 如果不支持或可用性未知,否则为 true 或 false

loadTileDataAvailability(_x, _y, _level) → Promise.<void>|undefined

确保我们加载了瓦片的可用性数据。
Name Type Description
_x number 请求几何数据的瓦片的X坐标。
_y number 请求几何数据的瓦片的Y坐标。
_level number 请求几何数据的瓦片层级。
Returns:
Undefined 如果无需加载,或当所有必需的瓦片被加载时Promise会解析。

requestTileGeometry(x, y, level, request) → Promise.<Cesium3DTilesTerrainData>|undefined

请求特定 tiles 的几何数据。此函数不应在之前调用 Cesium3DTilesTerrainProvider#ready 返回 true。结果必须包含地形数据 可选择性地包含水掩码以及哪些子 tiles 可用的指示信息
Name Type Description
x number 请求几何数据的 tiles 的 X 坐标
y number 请求几何数据的 tiles 的 Y 坐标
level number 请求几何数据的 tiles 的层级
request Request optional 请求对象。仅用于内部使用
Returns:
A 请求几何数据的 promise。如果此方法 返回 undefined 而不是 promise,说明当前有太多请求正在等待中 并将在稍后重试

Type Definitions

Cesium.Cesium3DTilesTerrainProvider.ConstructorOptions

Cesium3DTilesTerrainProvider构造器的初始化选项
Properties:
Name Type Attributes Default Description
requestVertexNormals boolean <optional>
false 标志,指示客户端是否应从服务器请求额外的光照信息,如果可用则以每个顶点法线形式提供。
requestWaterMask boolean <optional>
false 标志,指示客户端是否应从服务器请求瓦片水掩膜,如果可用。
ellipsoid Ellipsoid <optional>
Ellipsoid.default 椭球体。如果未指定,则使用WGS84椭球体。
credit Credit | string <optional>
数据源的标识,在画布上显示。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.