Настройка управления камерой,Настройка управления камерой

Выберите платформу: Android iOS JavaScript

Пользователи могут управлять масштабированием, наклоном, положением и вращением камеры с помощью жестов на карте. Вы также можете настроить камеру программно.

Диаграмма, иллюстрирующая 3D-модель камеры

Положение камеры

Вид карты моделируется как камера , смотрящая на определенную точку в трехмерном пространстве. Положение и ориентация камеры (и, следовательно, рендеринг карты) определяются следующими свойствами: центр (широта/долгота/высота местоположения, на которое смотрит камера), направление, наклон, диапазон и крен.

Центр (Широта/Долгота/Высота)

Центр определяет конкретную точку в трехмерном пространстве, которую наблюдает камера. Она указывается с помощью значений широты, долготы и высоты. Это позволяет точно позиционировать фокусную точку камеры в трех измерениях.

Широта может быть в диапазоне от -90 до 90 градусов включительно. Значения выше или ниже этого диапазона будут ограничены ближайшим значением в этом диапазоне. Например, указание широты 100 установит значение 90. Долгота находится в диапазоне от -180 до 180 градусов включительно. Высота указывается в метрах над уровнем моря.

Заголовок

Направление камеры определяет направление, в котором будет указывать камера, измеряемое в градусах по часовой стрелке от истинного севера. Север соответствует 0 градусам, восток — 90 градусам, юг — 180 градусам, а запад — 270 градусам. Это определяет ориентацию камеры вокруг вертикальной оси центральной точки .

Наклон

Наклон определяет угол камеры относительно вертикальной оси, измеряемый в градусах. Наклон в 0 градусов означает, что камера направлена ​​прямо вниз на Землю ( надир ). Наклон в 90 градусов означает, что камера направлена ​​горизонтально в направлении, указанном заголовком .

Диапазон

Диапазон определяет расстояние в метрах между собственной позицией камеры и центральной точкой, на которую она смотрит. Диапазон может варьироваться от нуля метров (очень близко) до шестидесяти трех миллионов метров, что позволяет просматривать от очень близкого расстояния до действительно глобальной перспективы. Это эффективно контролирует, насколько «увеличенной» или «уменьшенной» выглядит карта.

Рулон

Крен задает угол камеры относительно горизонта, измеряемый в градусах. Этот параметр может использоваться для создания эффектов, таких как крен во время симуляции полета или даже полный бочкообразный крен, вращающий камеру вокруг ее оси обзора.

Управление камерой

Следующий пример кода демонстрирует, как программно управлять камерой.

Быстрый

public static var sanFrancisco: Camera = .init(
  latitude: 37.7845812,
  longitude: -122.3660241,
  altitude: 585,
  heading: 288.0,
  tilt: 75.0,
  roll: 0.0,
  range: 100)