Cesium3DTilesTerrainProvider

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

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

此功能尚未定型，可能会在未遵循 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 752

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

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

获取当此地形提供程序处于活动状态时要显示的版权信息。通常用于为地形来源提供版权归属。

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

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

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

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

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

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

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

获取此提供程序使用的切片方案。

Methods

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

根据 Cesium ion 资产 ID 创建一个以 Cesium 3D Tiles 格式访问地形数据的 TerrainProvider
Name Type Description
assetId number Cesium ion 资产 ID。
options CesiumTerrainProvider.ConstructorOptions optional 描述初始化选项的对象。
Returns:
Throws:
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

创建一个以 Cesium 3D Tiles 格式访问地形数据的 TerrainProvider。
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 673

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

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

确定某个瓦片的数据是否可用于加载。
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 659

确保加载某个瓦片的可用性数据
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 234

请求给定瓦片的几何数据。此函数不应在 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>
 数据源的版权信息，显示在画布上。
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets