KBE3D / KBCore / Cesium / sampleTerrainMostDetailed

函数: sampleTerrainMostDetailed()

sampleTerrainMostDetailed(terrainProvider: TerrainProvider, positions: Cartographic[], rejectOnTileFail?: boolean): Promise<Cartographic[]>

Initiates a sampleTerrain() request at the maximum available tile level for a terrain dataset.

参数

terrainProvider

TerrainProvider

The terrain provider from which to query heights.

positions

Cartographic[]

The positions to update with terrain heights.

rejectOnTileFail?

boolean

If true, for a failed terrain tile request the promise will be rejected. If false, returned heights will be undefined.

返回

Promise<Cartographic[]>

A promise that resolves to the provided list of positions when terrain the query has completed. This promise will reject if the terrain provider's availability property is undefined.

示例

// Query the terrain height of two Cartographic positions
const terrainProvider = await Cesium.createWorldTerrainAsync();
const positions = [
    Cesium.Cartographic.fromDegrees(86.925145, 27.988257),
    Cesium.Cartographic.fromDegrees(87.0, 28.0)
];
const updatedPositions = await Cesium.sampleTerrainMostDetailed(terrainProvider, positions);
// positions[0].height and positions[1].height have been updated.
// updatedPositions is just a reference to positions.

// To handle tile errors, pass true for the rejectOnTileFail parameter.
try {
   const updatedPositions = await Cesium.sampleTerrainMostDetailed(terrainProvider, positions, true);
} catch (error) {
  // A tile request error occurred.
}