Как настроить управление камерой

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

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

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

Ориентация камеры

Модель представления карты предполагает направление камеры на определенную точку в пространстве. Положение и ориентация камеры определяются координатами широты, долготы и высоты, а также направлением, наклоном, диапазоном и креном.

широта, долгота, высота;

Начальное положение камеры определяется широтой, долготой и высотой. Эти значения определяют, где расположена камера, а не куда она направлена или на чем сфокусирована.

Широта может принимать значение от -90 до 90 градусов включительно. Долгота может принимать значение от -180 до 180 градусов включительно. Высота указывается в метрах над уровнем моря.

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

Направление

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

Наклон

Наклон – это угол камеры относительно вертикальной оси, измеряемый в градусах. При нулевом угле наклона камера направлена вертикально вниз (в надир). При угле наклона 90 градусов камера направлена горизонтально в сторону, заданную ориентацией.

Диапазон

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

Угол поворота

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

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

В приведенном ниже примере кода показано, как управлять камерой программно.

Swift 


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

Элементы управления пользовательского интерфейса

Помимо стандартных жестов, Maps 3D SDK для iOS также предоставляет элементы управления пользовательского интерфейса для изменения положения камеры.

  • Масштабирование – кнопки "+" и "-" для изменения масштаба карты.
  • Перемещение – кнопки "←", "→", "↑" и "↓" для изменения центра карты.
  • Поворот – кнопки "↺" и "↻" для изменения направления камеры.
  • Наклон – кнопки "^" и "⌄" для изменения наклона камеры.
  • Компас указывает направление на север и позволяет сбросить ориентацию камеры на север.

В приведенном ниже примере кода показано, как изменить видимость элементов управления пользовательского интерфейса.

swift struct ContentView: View { @State private var showControls = true</p> <p>var body: some View { Map(mode: .hybrid) .mapControls(at: .trailing) { if showControls { CompassControl() ZoomControl() TiltControl() } } } } ```