Понимать и использовать режимы высоты

Свойство AltitudeMode определяет вертикальное положение элемента карты. Оно определяет, отображается ли объект относительно рельефа местности, относительно надземных объектов (например, зданий) или на абсолютной высоте над уровнем моря.

AltitudeMode — это свойство, определяющее положение элементов, добавляемых на 3D-карту, таких как маркеры, полилинии, полигоны и модели, относительно поверхности Земли. Кроме того, AltitudeMode управляет положением камеры во время анимаций flyCameraTo и flyCameraAround .

В данном руководстве представлена ​​информация об эффективном использовании AltitudeMode , а также рассматриваются факторы, влияющие на отображение элементов.

Цифровые модели рельефа

Размещение объектов определяется двумя базовыми цифровыми моделями рельефа (ЦМР), доступными через API:

  • Цифровая модель рельефа (ЦМР) / «Земля» : вид «голой земли», показывающий высоту нижележащего рельефа, без надземных объектов.
  • Цифровая модель поверхности (ЦМП) / «Сетка» : представление поверхности, включающее высоту рельефа, а также надземные объекты, такие как здания и деревья.

На следующем изображении показана разница между цифровой моделью рельефа (ЦМР) и цифровой моделью поверхности (ЦМП) городской территории:

Изображение, демонстрирующее расположенные рядом цифровые модели рельефа (DTM) и цифровую модель рельефа (DSM) Колизея.

Параметры AltitudeMode

Выбор параметра AltitudeMode определяет, как значение высоты объекта (если оно указано) интерпретируется относительно цифровых моделей рельефа.

  • ABSOLUTE : Отображает объект относительно среднего уровня моря, рассчитанного с помощью EGM96 .
  • CLAMP_TO_GROUND : Отображает объект непосредственно на цифровой модели рельефа (на земле), игнорируя заданную высоту и следуя рельефу местности.
  • RELATIVE_TO_GROUND : Отображает объект относительно поверхности цифровой модели рельефа (земли).
  • RELATIVE_TO_MESH : Отображает объект относительно цифровой модели рельефа (сетки) — самой верхней поверхности, включая землю, здания и воду.

Значения высоты в относительных режимах

При использовании относительных режимов ( RELATIVE_TO_GROUND или RELATIVE_TO_MESH ) заданное значение высоты представляет собой смещение относительно выбранной базовой поверхности, а не фиксированную высоту над уровнем моря. Например, высота 100 разместит объект на 100 метров выше цифровой модели рельефа (ЦМР) или цифровой модели поверхности (ЦМП).

Если данные объекта не содержат информацию о высоте, относительный режим, например RELATIVE_TO_MESH , разместит объект непосредственно поверх сетки/поверхности. Однако для полилиний и полигонов соединения между точками будут прямыми линиями, что может привести к прохождению линии через сетку между точками, если не используется интерполяция.