Автоматически подгонять камеру под элементы карты

Вы можете автоматически кадрировать маркеры, ломаные линии, многоугольники и 3D-маршруты в области просмотра <gmp-map-3d>, задав HTML-атрибут autofits-camera или свойство autofitsCamera для поддерживаемых дочерних элементов. Если включен один или несколько дочерних элементов, карта рассчитывает положение камеры так, чтобы все включенные элементы оставались в поле зрения.

Автоматическая настройка камеры доступна в канале v=beta Maps JavaScript API. Инструкции по загрузке бета-канала приведены в разделе Версии.

Поддерживаемые элементы

В таблице ниже перечислены дочерние элементы Map3DElement, которые поддерживают autofits-camera (autofitsCamera).

элемент HTML Класс JavaScript Библиотека Примечания
<gmp-marker-3d>, <gmp-marker-3d-interactive> Marker3DElement, Marker3DInteractiveElement maps3d Определяет position маркера.
<gmp-marker>, <gmp-marker-interactive> MarkerElement, MarkerInteractiveElement maps3d Определяет position маркера.
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> Polyline3DElement, Polyline3DInteractiveElement maps3d Ограничивает все координаты в path ломаной линии.
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> Polygon3DElement, Polygon3DInteractiveElement maps3d Определяет границы всех координат в path многоугольника.
<gmp-route-3d> Route3DElement routes Ожидает разрешения запроса маршрута, а затем кадрирует путь маршрута.

Неподдерживаемые элементы

Model3DElement, PopoverElement и FlattenerElement не поддерживают autofitsCamera. Чтобы поместить эти элементы в рамку, задайте center и range для <gmp-map-3d> или вызовите flyCameraTo.

Подогнать камеру при начальной загрузке

Чтобы при загрузке карты в область просмотра попадали определенные элементы, добавьте атрибут autofits-camera к каждому дочернему элементу, который должен быть виден. Вам не нужно рассчитывать center или range на <gmp-map-3d>:

<gmp-map-3d
  style="height: 400px; width: 100%;"
  mode="hybrid">
  <gmp-marker-3d
    position="47.6205,-122.3493"
    title="Space Needle"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-marker-3d
    position="47.6097,-122.3425"
    title="Pike Place Market"
    autofits-camera>
  </gmp-marker-3d>
  <gmp-polyline-3d
    path="47.6205,-122.3493,0 47.6097,-122.3425,0"
    stroke-color="#4285F4"
    stroke-width="8"
    altitude-mode="clamp-to-ground"
    autofits-camera>
  </gmp-polyline-3d>
</gmp-map-3d>

<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>

Замените YOUR_API_KEY ключом API платформы Google Карт.

Как настроить размер и анимацию динамических обновлений

Если вы добавите элемент, на который дано согласие, после начальной загрузки, обновите его координаты или конечные точки маршрута или зададите для autofitsCamera значение true, карта пересчитает положение камеры, чтобы в кадр попали все элементы, на которые дано согласие. Если удалить элемент или задать для autofitsCamera значение false, камера останется на месте, а элемент не будет обновляться.

Чтобы управлять тем, как будут показываться динамические обновления (с привязкой или анимацией), задайте для свойства autofitsCameraAnimation (autofits-camera-animation) объекта Map3DElement значение AutofitsCameraAnimation:

  • AutofitsCameraAnimation.NONE ("none", по умолчанию) – переход к обновленной позиции без анимации.
  • AutofitsCameraAnimation.FLY_TO ("fly-to"): плавный переход к обновленной позиции. При первой загрузке карты переход происходит без анимации. Если в операционной системе пользователя включен режим уменьшения движения, то FLY_TO также переходит к точке без анимации.

Чтобы настроить autofitsCamera и AutofitsCameraAnimation.FLY_TO программно, воспользуйтесь примером ниже.

<div id="map-container" style="height: 400px; width: 100%;"></div>

<script>
  async function initMap() {
    const {
      AutofitsCameraAnimation,
      Map3DElement,
      Marker3DElement,
      MapMode,
    } = await google.maps.importLibrary('maps3d');

    const map = new Map3DElement({
      mode: MapMode.HYBRID,
      autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
    });
    document.getElementById('map-container').append(map);

    const originMarker = new Marker3DElement({
      position: { lat: 37.7955, lng: -122.3937 },
      autofitsCamera: true,
    });
    map.append(originMarker);

    /* Adding a second opted-in marker flies the camera to frame both. */
    const destinationMarker = new Marker3DElement({
      position: { lat: 37.8080, lng: -122.4177 },
      autofitsCamera: true,
    });
    map.append(destinationMarker);
  }
</script>
<script async
  src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>

Замените YOUR_API_KEY ключом API платформы Google Карт.

Как взаимодействуют свойства и ограничения камеры

Если хотя бы один дочерний элемент включен с помощью autofits-camera, Map3DElement объединяет конфигурацию карты с вычисленными границами в соответствии со следующими правилами:

  • center и range: переопределяются рассчитанным кадрированием, которое добавляет 20 % к диапазону и обеспечивает минимальный диапазон 80 м. Если ни один из дочерних элементов не предоставляет координаты, карта использует настроенные резервные значения center и range.
  • tilt и heading – обрабатываются как рекомендуемые значения при кадрировании. Если эти параметры не указаны, то по умолчанию используется значение 0°, которое соответствует виду сверху вниз с ориентацией на север.
  • roll и fov: сохраняются в соответствии с настройками на Map3DElement.
  • Асинхронные дочерние элементы. Перед отрисовкой начального представления Map3DElement ожидает, пока асинхронные дочерние элементы, для которых включена эта функция, такие как <gmp-route-3d>, завершат загрузку геометрии маршрута.
  • Ограничения карты и камеры. Географические ограничения bounds и ограничения камеры (minAltitude, maxAltitude, minTilt, maxTilt, minHeading и maxHeading) по-прежнему ограничивают автоматически подогнанную область просмотра. Подробнее о том, как ограничить область просмотра и границы камеры…

Дальнейшие действия