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.sampleTerrainMostDetailed(terrainProvider, positions);
bmgl.when(promise, function(updatedPositions) {
    // positions[0].height and positions[1].height have been updated.
    // updatedPositions is just a reference to positions.
});