AltitudeMode は、地図要素の垂直方向の配置を定義するプロパティです。オブジェクトが地形に対して相対的にレンダリングされるか、地上構造物（建物など）に対して相対的にレンダリングされるか、海抜を基準とした絶対的な高さでレンダリングされるかを決定します。
AltitudeMode は、マーカー、ポリライン、ポリゴン、モデルなど、3D 地図に追加する要素が地表に対して相対的にどこにレンダリングされるかを決定するプロパティです。また、AltitudeMode は、flyTo アニメーションと flyAround アニメーション中にカメラが配置される場所を制御します。
次のガイドでは、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 に設定すると、フィーチャーは DTM または DSM の 100 メートル上に配置されます。
標高がフィーチャー データに含まれていない場合、RELATIVE_TO_MESH などの相対モードでは、フィーチャーはメッシュ/サーフェスの真上に配置されます。ただし、ポリラインとポリゴンの場合、ポイント間の接続は直線になります。補間を使用しないと、ポイント間のメッシュを線が通過する可能性があります。
次のステップ
AltitudeModeとマーカーに関する情報など、AltitudeModeの詳細な概要については、アーキテクチャ センターのトピックをご覧ください。