AltitudeMode は、地図要素の垂直方向の配置を定義するプロパティです。オブジェクトが地形に対して相対的にレンダリングされるか、地上構造物（建物など）に対して相対的にレンダリングされるか、海抜を基準とした絶対的な高さでレンダリングされるかを決定します。
AltitudeMode は、マーカー、ポリライン、ポリゴン、モデルなど、3D 地図に追加する要素が地表面に対して相対的にどこにレンダリングされるかを決定するプロパティです。
次のガイドでは、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 は、地面、建物、水面を含む最も高い表面です。
次のサンプルでは、ポリラインの AltitudeMode を変更して、さまざまなモードが半都市部の複雑なジオメトリでのポリラインのレンダリングにどのように影響するかを確認できます。
相対モードの高度値
相対モード（RELATIVE_TO_GROUND または RELATIVE_TO_MESH）を使用する場合、指定された高度の値は、選択した基準面からのオフセットであり、海抜からの固定された高さではありません。たとえば、高度を 100 に設定すると、地表モデルまたは DSM の 100 メートル上にフィーチャーが配置されます。
標高がフィーチャー データに含まれていない場合、RELATIVE_TO_MESH などの相対モードでは、フィーチャーがメッシュ/サーフェスの真上に配置されます。ただし、ポリラインとポリゴンの場合、点間の接続は直線になります。補間を使用しないと、線が点間のメッシュを通過する可能性があります。
次のステップ
AltitudeModeとマーカーに関する情報など、AltitudeModeの詳細な概要については、アーキテクチャ センターのトピックをご覧ください。