瞭解及使用高度模式

AltitudeMode 是定義地圖元素垂直位置的屬性。這項設定會決定物件的算繪方式，包括相對於地形、相對於地面特徵 (例如建築物)，或相對於海平面的絕對高度。

AltitudeMode 屬性決定您新增至 3D 地圖的元素 (例如標記、折線、多邊形和模型)，相對於地球表面的算繪位置。此外，AltitudeMode 可控制攝影機在 flyCameraTo 和 flyCameraAround 動畫期間的位置。

以下指南提供有效使用 AltitudeMode 的資訊，以及影響元素算繪方式的考量因素。

數位海拔模型

地圖項目位置由 API 中可存取的兩個基礎數位高程模型 (DEM) 控制：

  • 數位地形模型 (DTM)/「地面」：「裸地」檢視畫面，顯示下方地形的海拔高度，並移除地面上的物體。
  • 數位地表模型 (DSM)/「網格」：呈現地表特徵，包括地形高度和建築物、樹木等地面特徵。

下圖顯示市區 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 等相對模式會將地圖項目直接放在網格/表面上方。不過，折線和多邊形的點之間會以直線連接，如果不使用內插法，線條可能會穿過點之間的網格。