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

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

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

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

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

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

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

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

Изображение, демонстрирующее одновременное отображение цифровой модели рельефа (DTM) и цифровой модели поверхности (DSM) Эйфелевой башни и Парижа.

AltitudeMode options

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

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

В следующем примере показано, как изменить AltitudeMode полилинии, чтобы увидеть, как различные режимы влияют на отображение полилинии на сложной геометрии в полугородской среде:

Altitude values in relative modes

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

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

Следующие шаги