На этой странице содержится информация об основных функциях фотореалистичных 3D-карт в Maps JavaScript, которые позволяют создавать интерактивные и захватывающие трехмерные изображения. Следующая документация охватывает:
- Обработка событий пользовательского интерфейса для беспрепятственного взаимодействия.
- Включая элементы управления исследованием для навигации в 3D-пространстве.
- Использование предустановленных траекторий камеры для экскурсий.
- Применение ограничений камеры для сохранения фокуса на определенной области.
События пользовательского интерфейса
В этом разделе описаны интерактивные события и уведомления об изменении состояния, которые вы можете прослушивать и обрабатывать программно при работе с 3D-картами. JavaScript в браузере управляется событиями, то есть он реагирует на действия пользователя, генерируя события, которые ваша программа может прослушивать и соответствующим образом выполнять код.
Существует два основных типа событий:
- События взаимодействия с пользователем (например, щелчки мыши) передаются из области просмотра 3D-карты в ваш код. Эти события позволяют вам реагировать на прямые действия пользователя в среде 3D-карты. Посмотреть образец .
- Уведомления об изменении состояния отражают обновления базовых моделей данных 3D-карты и состояния рендеринга с использованием традиционной схемы именования
property_changed
.
Каждый объект API 3D-картографии предоставляет набор именованных событий, для которых ваша программа может регистрировать прослушиватели событий и выполнять логику, когда эти события происходят, с помощью встроенной функции addEventListener()
. В следующем примере показаны распространенные события, которые происходят, когда пользователь взаимодействует с трехмерной картой.
В следующем примере показано, какие события запускаются при взаимодействии пользователя с картой:
Средства управления разведкой
Карты, отображаемые в фотореалистичных 3D-картах в Maps JavaScript API, содержат элементы пользовательского интерфейса, которые поддерживают взаимодействие пользователя с картой. Эти элементы известны как пользовательские элементы управления . Элементы управления исследованием включены по умолчанию, но вы можете отключить их в своем приложении.
На следующем изображении показаны элементы управления по умолчанию, отображаемые фотореалистичными 3D-картами в Maps JavaScript:
Ниже приведен список полного набора элементов управления фотореалистичных 3D-карт в Maps JavaScript:
- Элемент управления масштабированием отображает кнопки «+» и «-» для изменения уровня масштабирования карты.
- Элемент управления наклоном позволяет изменять наклон камеры.
- Элемент управления «Поворот» позволяет изменить направление камеры.
- Элемент управления перемещением отображает кнопки « ←», «→», «↑» и «↓» для изменения центра карты.
Управление камерой и анимация
Предустановленные траектории камеры
Фотореалистичные 3D-карты в Maps JavaScript предоставляет два предустановленных пути движения камеры. Траектории камеры можно настроить, изменив продолжительность анимации (тем самым увеличивая или уменьшая скорость) или комбинируя их для создания более кинематографического впечатления.
Фотореалистичные 3D-карты в Maps JavaScript поддерживают следующие пути движения камеры:
- Анимация
FlyCameraTo
летит из центра карты в указанный пункт назначения. - Анимация
FlyCameraAround
вращается вокруг точки на карте столько раз, сколько вы укажете.
Два доступных пути можно объединить, чтобы долететь до интересующей точки, вращаться вокруг нее и затем остановиться, когда это необходимо.
Ограничения камеры
Возможно, вам будет желательно контролировать панорамирование камеры, максимальную высоту или создавать границы широты и долготы, ограничивающие движение пользователя на данной карте. Сделать это можно с помощью ограничений камеры.
Пример того, как работают и реализуются ограничения камеры, можно посмотреть в демо .