sampleTerrain(terrainProvider, level, positions) → Promise.<Array.<Cartographic>>
启动
Cartographic
位置数组的地形高度查询,方法是
从地形提供者请求平铺、采样和插值。插值
匹配用于在指定级别渲染地形的三角形。质询
异步发生,因此此函数返回一个promise,当
查询完成。每个点的高度都会进行适当的修改。如果一个高度不能
因为该位置的指定标高没有可用的地形数据,
或者发生另一个错误,高度设置为未定义。这是典型的
Cartographic
型,提供的高度为参考椭球体以上的高度
(如Ellipsoid.WGS84
)而不是高于平均海平面的高度。在其他
换句话说,如果在海洋中取样,它不一定是0.0。此函数需要
如果你需要精确地得到地形的高度
尽可能使用sampleTerrainMostDetailed
。Name | Type | Description |
---|---|---|
terrainProvider |
TerrainProvider | 要从中查询高度的地形提供程序。 |
level |
Number | 从中查询地形高度的地形详细级别。 |
positions |
Array.<Cartographic> | 要随地形高度更新的位置。 |
Returns:
当地形查询完成时,解析为所提供的位置列表的承诺。
Example:
// Query the terrain height of two Cartographic positions
var terrainProvider = Cesium.createWorldTerrain();
var positions = [
Cesium.Cartographic.fromDegrees(86.925145, 27.988257),
Cesium.Cartographic.fromDegrees(87.0, 28.0)
];
var promise = Cesium.sampleTerrain(terrainProvider, 11, positions);
Cesium.when(promise, function(updatedPositions) {
// positions[0].height and positions[1].height have been updated.
// updatedPositions is just a reference to positions.
});