Вы можете автоматически кадрировать маркеры, ломаные линии, многоугольники и 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) по-прежнему ограничивают автоматически подогнанную область просмотра. Подробнее о том, как ограничить область просмотра и границы камеры…