通过向地形提供者请求地砖、采样和插值,为
Cartographic
位置数组启动地形高度查询。插值匹配用于在指定级别渲染地形的三角形。查询是异步进行的,因此此函数返回一个在查询完成时解决的承诺。每个点的高度都会在适当的位置进行修改。如果由于没有地形数据可用于该位置的指定高程而无法确定高度,或发生其他错误,则高度设置为“未定义”。正如典型的Cartographic
类型,所提供的高度是高于参考椭球体(如Ellipsoid.WGS84
)的高度,而不是高于平均海平面的高度。换句话说,如果在海洋中取样,它不一定是0.0。如果您需要尽可能精确地获得地形的高度(即具有最大详细程度),则此功能需要输入地形详细程度。
Parameters:
level
(Number)
从中查询地形高度的详细地形级别。
Example
// Query the terrain height of two Cartographic positions
var terrainProvider = bmgl.createWorldTerrain();
var positions = [
bmgl.Cartographic.fromDegrees(86.925145, 27.988257),
bmgl.Cartographic.fromDegrees(87.0, 28.0)
];
var promise = bmgl.sampleTerrain(terrainProvider, 11, positions);
bmgl.when(promise, function(updatedPositions) {
// positions[0].height and positions[1].height have been updated.
// updatedPositions is just a reference to positions.
});
- sampleTerrainMostDetailed