通過(guò)向地形提供者請(qǐng)求地磚、采樣和插值,為
Cartographic
位置數(shù)組啟動(dòng)地形高度查詢。插值匹配用于在指定級(jí)別渲染地形的三角形。查詢是異步進(jìn)行的,因此此函數(shù)返回一個(gè)在查詢完成時(shí)解決的承諾。每個(gè)點(diǎn)的高度都會(huì)在適當(dāng)?shù)奈恢眠M(jìn)行修改。如果由于沒(méi)有地形數(shù)據(jù)可用于該位置的指定高程而無(wú)法確定高度,或發(fā)生其他錯(cuò)誤,則高度設(shè)置為“未定義”。正如典型的Cartographic
類型,所提供的高度是高于參考橢球體(如Ellipsoid.WGS84
)的高度,而不是高于平均海平面的高度。換句話說(shuō),如果在海洋中取樣,它不一定是0.0。如果您需要盡可能精確地獲得地形的高度(即具有最大詳細(xì)程度),則此功能需要輸入地形詳細(xì)程度。
Parameters:
level
(Number)
從中查詢地形高度的詳細(xì)地形級(jí)別。
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