通過向地形提供者請求地磚、采樣和插值,為
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