Пользователи могут управлять масштабированием, наклоном, положением и вращением камеры с помощью жестов на карте. Вы также можете настроить камеру программно.
Положение камеры
Вид карты моделируется как камера , смотрящая на определенную точку в трехмерном пространстве. Положение и ориентация камеры (и, следовательно, рендеринг карты) определяются следующими свойствами: центр (широта/долгота/высота местоположения, на которое смотрит камера), направление, наклон, диапазон и крен.
Центр (Широта/Долгота/Высота)
Центр определяет конкретную точку в трехмерном пространстве, которую наблюдает камера. Это указывается с помощью класса LatLngAltitude , который объединяет значения широты, долготы и высоты. Это позволяет точно позиционировать фокусную точку камеры в трех измерениях.
Широта может быть от -90 до 90 градусов включительно. Долгота варьируется от -180 до 180 градусов включительно. Высота указывается в метрах над уровнем моря.
Заголовок
Направление камеры определяет направление, в котором будет указывать камера, измеряемое в градусах по часовой стрелке от истинного севера. Север соответствует 0 градусам, восток — 90 градусам, юг — 180 градусам, а запад — 270 градусам. Это определяет ориентацию камеры вокруг вертикальной оси центральной точки .
Наклон
Наклон определяет угол камеры относительно вертикальной оси, измеряемый в градусах. Наклон в 0 градусов означает, что камера направлена прямо вниз на Землю ( надир ). Наклон в 90 градусов означает, что камера направлена горизонтально в направлении, указанном заголовком .
Диапазон
Диапазон определяет расстояние в метрах между собственной позицией камеры и центральной точкой, на которую она смотрит. Диапазон может варьироваться от нуля метров (очень близко) до шестидесяти трех миллионов метров, что позволяет просматривать от очень близкого расстояния до действительно глобальной перспективы. Это эффективно контролирует, насколько «увеличенной» или «уменьшенной» выглядит карта.
Рулон
Крен задает угол камеры относительно горизонта, измеряемый в градусах. Этот параметр может использоваться для создания эффектов, таких как крен во время симуляции полета или даже полный бочкообразный крен, вращающий камеру вокруг ее оси обзора.
Управление камерой
Следующий пример кода демонстрирует, как программно управлять камерой, вызывая метод setCamera . Чтобы использовать этот пример кода, следуйте инструкциям в разделе Настройка и Добавление 3D-карты в приложение , чтобы настроить проект Android Studio с базовой 3D-картой. Затем добавьте следующий код в файл MainActivity.kt :
// Add imports import com.google.android.gms.maps3d.model.latLngAltitude ... // Add to the onMap3DViewReady method, after the googleMap3D object has been initialized googleMap3D.setCamera( camera { center = latLngAltitude { latitude = 38.743502 longitude = -109.499374 altitude = 1467.0 } heading = 350.0 tilt = 58.1 range = 138.2 roll = 0.0 } )