AltitudeMode は、地図要素の垂直方向の配置を定義するプロパティです。
オブジェクトを地形に対して相対的にレンダリングするか、地上構造物（建物など）に対して相対的にレンダリングするか、海抜からの絶対高さでレンダリングするかを決定します。
AltitudeMode は、マーカー、ポリライン、ポリゴン、モデルなど、3D 地図に追加する要素が地球表面に対して相対的にレンダリングされる場所を決定するプロパティです。また、AltitudeMode は、flyCameraTo アニメーションと flyCameraAround アニメーションでカメラが配置される場所を制御します。
次のガイドでは、AltitudeMode を効果的に使用する方法と、要素のレンダリング方法に影響する要因について説明します。
数値標高モデル
フィーチャーの配置は、API でアクセスできる 2 つの基盤となる数値標高モデル（DEM）によって管理されます。
- 数値地形モデル（DTM） / 「地面」: 地上構造物を取り除き、基盤となる地形の標高を示す「裸地」ビュー。
- 数値表層モデル（DSM） / 「メッシュ」: 地形の標高に加えて、建物や樹木などの地上構造物を含む表面表現。
次の画像は、都市部の DTM レンダリングと DSM レンダリングの違いを示しています。
AltitudeMode のオプション
AltitudeMode の選択によって、フィーチャーの標高値（指定されている場合）が数値標高モデルに対して相対的に解釈される方法が決まります。
ABSOLUTE: 平均海面に対して相対的にオブジェクトをレンダリングします。 計算には EGM96を使用します。CLAMP_TO_GROUND: 提供された標高を無視して、地形に沿って DTM（地面）に直接オブジェクトをレンダリングします。RELATIVE_TO_GROUND: DTM（地面）の表面に対して相対的にオブジェクトをレンダリングします。RELATIVE_TO_MESH: DSM（メッシュ）に対して相対的にオブジェクトをレンダリングします。DSM は、地面、建物、水を含む最も高い表面です。
相対モードの標高値
相対モード（RELATIVE_TO_GROUND または RELATIVE_TO_MESH）を使用する場合、指定された標高値は、選択した基準面からのオフセットであり、海抜からの固定高さではありません。たとえば、標高が 100 の場合、フィーチャーは DTM または DSM から 100 メートル上に配置されます。
フィーチャー データに標高が含まれていない場合、RELATIVE_TO_MESH などの相対モードでは、フィーチャーはメッシュ/サーフェスの真上に配置されます。
ただし、ポリラインとポリゴンの場合、点間の接続は直線になります。補間を使用しないと、線が点間のメッシュを通過する可能性があります。