AltitudeMode 屬性會定義地圖元素的垂直位置。
這項屬性會決定物件的算繪方式,是相對於地形、相對於地面上的特徵 (例如建築物),還是相對於海平面高度。
AltitudeMode 屬性會決定要將新增至 3D 地圖的元素 (例如標記、折線、多邊形和模型) 算繪在地球表面的哪個位置。
以下指南提供有效使用 AltitudeMode 的相關資訊,以及影響元素算繪方式的因素考量。
數位高程模型
地標放置位置取決於 API 中提供的兩種基礎數位高程模型 (DEM):
- 數位地形模型 (DTM) /「地面」:顯示下方地形海拔高度的「裸地」檢視畫面,並移除地面上的物體。
- 數位地表模型 (DSM) /「網格」:地表呈現方式,包括地形海拔高度,以及建築物和樹木等地面以上特徵。
下圖顯示城市區域的 DTM 和 DSM 算繪結果差異:

AltitudeMode 種付款方式
AltitudeMode 的選擇會決定如何解讀相對於數位高程模型的特徵海拔高度值 (如有提供)。
ABSOLUTE:根據EGM96 計算結果,以平均海平面為基準算繪物件。CLAMP_TO_GROUND:直接在 DTM (地面) 上算繪物件,忽略任何提供的高度並追蹤地形。RELATIVE_TO_GROUND:根據 DTM (地面) 表面算繪物件。RELATIVE_TO_MESH:根據 DSM (網格) 算繪物件,也就是最高表面,包括地面、建築物和水體。
在下列範例中,您可以變更折線的 AltitudeMode,觀察各種模式如何影響半市區環境中複雜幾何圖形的折線算繪:
相對模式中的海拔高度值
使用相對模式 (RELATIVE_TO_GROUND 或 RELATIVE_TO_MESH) 時,提供的高度值是所選基準面的偏移值,而非高於海平面的固定高度。舉例來說,如果高度為 100,這項功能就會放置在 DTM 或 DSM 上方 100 公尺處。
如果特徵資料未包含海拔高度,RELATIVE_TO_MESH 等相對模式會將特徵直接放在網格/表面上。不過,如果是折線和多邊形,點之間的連線會是直線,如果沒有使用插補,線條可能會穿過點之間的網格。
後續步驟
- 如要深入瞭解
AltitudeMode,包括AltitudeMode和標記的相關資訊,請參閱架構中心主題。