sampleTerrain

通过向地形提供者请求地砖、采样和插值,为Cartographic位置数组启动地形高度查询。插值匹配用于在指定级别渲染地形的三角形。查询是异步进行的,因此此函数返回一个在查询完成时解决的承诺。每个点的高度都会在适当的位置进行修改。如果由于没有地形数据可用于该位置的指定高程而无法确定高度,或发生其他错误,则高度设置为“未定义”。正如典型的Cartographic类型,所提供的高度是高于参考椭球体(如Ellipsoid.WGS84)的高度,而不是高于平均海平面的高度。换句话说,如果在海洋中取样,它不一定是0.0。如果您需要尽可能精确地获得地形的高度(即具有最大详细程度),则此功能需要输入地形详细程度。
Parameters:
terrainProvider (TerrainProvider) 从中查询高度的地形提供程序。
level (Number) 从中查询地形高度的详细地形级别。
positions (Array.<Cartographic>) 要随地形高度更新的位置。
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.
});
See:
  • sampleTerrainMostDetailed