高度モードを理解して使用する

AltitudeMode は、マップ要素の垂直方向の配置を定義するプロパティです。 オブジェクトを地形を基準にしてレンダリングするか、地上の特徴（建物など）を基準にしてレンダリングするか、海抜の絶対高度でレンダリングするかを決定します。

AltitudeMode は、マーカー、ポリライン、ポリゴン、モデルなど、3D 地図に追加する要素が地表に対してどこにレンダリングされるかを決定するプロパティです。また、AltitudeMode は、flyCameraTo アニメーションと flyCameraAround アニメーション中にカメラが配置される場所を制御します。

次のガイドでは、AltitudeMode を効果的に使用する方法と、要素のレンダリング方法に影響する要因に関する考慮事項について説明します。

数値標高モデル

特徴の配置は、API でアクセス可能な 2 つの基盤となるデジタル標高モデル（DEM）によって制御されます。

  • 数値地形モデル（DTM）/「地面」: 地上のオブジェクトを削除した、基盤となる地形の標高を示す「裸地」ビュー。
  • 数値表層モデル（DSM）/「メッシュ」: 地形の標高に加えて、建物や樹木などの地上の特徴を含む地表の表現。

次の画像は、都市部の 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 などの相対モードでは、対象物がメッシュ / サーフェスの真上に配置されます。ただし、ポリラインとポリゴンの場合、ポイント間の接続は直線になります。補間を使用しないと、ポイント間のメッシュを線が通過する可能性があります。