AltitudeMode 属性用于定义地图元素的垂直放置位置。
它决定了对象是相对于地形、相对于地面以上特征(如建筑物)还是相对于海平面的绝对高度进行渲染。
AltitudeMode 属性用于确定您添加到 3D 地图的元素(例如标记、折线、多边形和模型)相对于地球表面的渲染位置。此外,AltitudeMode 还控制着在 flyCameraTo 和 flyCameraAround 动画期间摄像头的位置。
以下指南提供了有关如何有效使用 AltitudeMode 的信息,以及影响元素渲染方式的因素注意事项。
数字高程模型
要素放置位置由 API 中可访问的两个底层数字高程模型 (DEM) 控制:
- 数字地形模型 (DTM) /“地面” :一种“裸地”视图,显示了底层地形的高程,并移除了地面以上对象。
- 数字表面模型 (DSM) /“网格” :一种表面表示形式,包括地形高程以及地面以上特征(如建筑物和树木)。
下图显示了城市区域的 DTM 和 DSM 渲染之间的区别:

AltitudeMode 选项
选择 AltitudeMode 可确定如何相对于数字高程模型解读要素的海拔值(如果提供)。
ABSOLUTE:相对于使用 EGM96 计算的平均海平面渲染对象。CLAMP_TO_GROUND:直接在 DTM(地面)上渲染对象,忽略任何提供的高程并遵循地形。RELATIVE_TO_GROUND:相对于 DTM(地面)表面渲染对象。RELATIVE_TO_MESH:相对于 DSM(网格)渲染对象,即最高表面,包括地面、建筑物和水体。
相对模式下的高程值
使用相对模式(RELATIVE_TO_GROUND 或 RELATIVE_TO_MESH)时,提供的高程值是相对于所选基准表面的偏移量,而不是相对于海平面的固定高度。例如,高程为 100 会将要素放置在 DTM 或 DSM 上方 100 米处。
如果要素数据不包含高程,则 RELATIVE_TO_MESH 等相对模式会将要素直接放置在网格/表面之上。
但是,对于折线和多边形,点之间的连接将是直线,如果您不使用插值,可能会导致线条穿过点之间的网格。