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（メッシュ）を基準にオブジェクトをレンダリングします。
相対モードの高度値
相対モード（RELATIVE_TO_GROUND または RELATIVE_TO_MESH）を使用する場合、指定された高度の値は、選択した基準面からのオフセットであり、海抜からの固定された高さではありません。たとえば、高度を 100 に設定すると、フィーチャーは DTM または DSM の 100 メートル上に配置されます。
標高がフィーチャー データに含まれていない場合、RELATIVE_TO_MESH などの相対モードでは、フィーチャーがメッシュ/サーフェスの真上に配置されます。ただし、ポリラインとポリゴンの場合、点間の接続は直線になります。補間を使用しないと、線が点間のメッシュを通過する可能性があります。