Cesium3DTilesTerrainProvider

new Cesium.Cesium3DTilesTerrainProvider(options)
engine/Source/Core/Cesium3DTilesTerrainProvider.js 68

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

此功能不是最终的，在没有 Cesium 的标准弃用政策的情况下可能会发生变化。

See:
  • TerrainProvider
  • Cesium3DTilesTerrainProvider.fromUrl
  • Cesium3DTilesTerrainProvider.fromIonAssetId // Create GTOPO30 with vertex normals try { const viewer = new Cesium.Viewer("cesiumContainer", { terrainProvider: await Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(2732686, { requestVertexNormals: true }) }); } catch (error) { console.log(error); }

Members

availability : TileAvailability|undefined
engine/Source/Core/Cesium3DTilesTerrainProvider.js 746

获取一个可用于确定此提供者地形可用性的对象，例如 在某些点和矩形区域内。

credit : Credit
engine/Source/Core/Cesium3DTilesTerrainProvider.js 700

获取在此地形提供程序处于活动状态时显示的版权信息。通常用于标注地形的来源。

errorEvent : Event
engine/Source/Core/Cesium3DTilesTerrainProvider.js 689

获取当地形提供者遇到异步错误时触发的事件。通过订阅该事件，您将收到错误通知，并可能从中恢复。事件监听器会接收到 TileProviderError 的实例。

hasVertexNormals : boolean
engine/Source/Core/Cesium3DTilesTerrainProvider.js 735

获取一个值，用于指示请求的瓦片是否包含顶点法线。

hasWaterMask : boolean
engine/Source/Core/Cesium3DTilesTerrainProvider.js 724

获取一个值，指示提供程序是否包含水体掩码。水体掩码 指示全球哪些区域是水域而非陆地，以便可以将其呈现 为带有动画波纹的反射表面。

tilingScheme : TilingScheme
engine/Source/Core/Cesium3DTilesTerrainProvider.js 711

获取提供者使用的平铺方案。

Methods

static Cesium.Cesium3DTilesTerrainProvider.fromIonAssetId(assetId, options) → Promise.<CesiumTerrainProvider>
engine/Source/Core/Cesium3DTilesTerrainProvider.js 206

从 Cesium ion 资产 ID 创建一个 TerrainProvider，以访问 Cesium 3D 瓦片格式的地形数据
Name Type Description
assetId number Cesium ion 资产 ID。
options CesiumTerrainProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
Throws:
  • RuntimeError : layer.json does not specify a format
  • RuntimeError : layer.json specifies an unknown format
  • RuntimeError : layer.json specifies an unsupported quantized-mesh version
  • RuntimeError : layer.json does not specify a tiles property, or specifies an empty array
  • RuntimeError : layer.json does not specify any tile URL templates
Example:
// Create GTOPO30 with vertex normals
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>
engine/Source/Core/Cesium3DTilesTerrainProvider.js 138

创建一个 TerrainProvider，用于访问 Cesium 3D 瓦片格式的地形数据。
Name Type Description
url Resource | string | Promise.<Resource> | Promise.<string> Cesium 地形服务器的 URL。
options Cesium3DTilesTerrainProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
返回一个解析为地形提供者的 promise。
Example:
// Create terrain with normals.
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
engine/Source/Core/Cesium3DTilesTerrainProvider.js 671

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

getTileDataAvailable(x, y, level) → boolean|undefined
engine/Source/Core/Cesium3DTilesTerrainProvider.js 408

确定是否可以加载瓦片的数据。
Name Type Description
x number 要请求几何信息的瓦片的 X 坐标。
y number 要请求几何信息的瓦片的 Y 坐标。
level number 要请求几何信息的瓦片的级别。
Returns:
如果不支持或可用性未知则为 undefined，否则返回 true 或 false。

loadTileDataAvailability(_x, _y, _level) → Promise.<void>|undefined
engine/Source/Core/Cesium3DTilesTerrainProvider.js 657

确保我们为瓦片加载可用性数据
Name Type Description
_x number 要请求几何数据的瓦片的 X 坐标。
_y number 要请求几何数据的瓦片的 Y 坐标。
_level number 要请求几何数据的瓦片的级别。
Returns:
如果无需加载任何内容则为 undefined，或者在所有所需瓦片加载完成时解析的 Promise

requestTileGeometry(x, y, level, request) → Promise.<Cesium3DTilesTerrainData>|undefined
engine/Source/Core/Cesium3DTilesTerrainProvider.js 232

请求给定瓦片的几何信息。该函数在 Cesium3DTilesTerrainProvider#ready 返回 true 之前不应被调用。 结果必须包含地形数据，并且可以选择性地包含水体掩码以及哪些子瓦片可用的指示信息。
Name Type Description
x number 请求几何信息的瓦片的 X 坐标。
y number 请求几何信息的瓦片的 Y 坐标。
level number 请求几何信息的瓦片的级别。
request Request optional 请求对象。仅用于内部使用。
Returns:
请求几何信息的 Promise。如果此方法 返回 undefined 而不是 Promise，则表示请求过多，稍后将重试。

Type Definitions

Cesium.Cesium3DTilesTerrainProvider.ConstructorOptions
engine/Source/Core/Cesium3DTilesTerrainProvider.js 29

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.
CtrlK
packages/engine
packages/widgets