Поделиться через

Обработка событий карты

  • Статья

В этой статье показано, как использовать класс событий карты. Это свойство выделяет события на карте и разных слоях карты. Также можно выделить события при взаимодействии с HTML-меткой.

Взаимодействие с картой

В примере "События карты" выделено имя событий, которые запускаются при взаимодействии с картой. Исходный код для этого примера см . в разделе "Исходный код событий карты".

A screenshot showing a map with a list of map events that are highlighted anytime your actions on the map trigger that event.

Взаимодействие со слоями карты

В примере "События слоя" выделено имя событий, которые запускаются при взаимодействии с уровнем символов. Слои символов, пузырьков, линий и многоугольников поддерживают одинаковый набор событий. Эти события не поддерживаются тепловой картой и слоями плиток. Исходный код для этого примера см . в исходном коде событий уровня.

A screenshot showing a map with a list of layer events that are highlighted anytime you interact with the Symbol Layer.

Взаимодействие с маркером HTML

В примере событий слоя маркеров HTML выделяется имя событий, которые запускаются при взаимодействии с уровнем маркера HTML. Исходный код для этого примера см . в исходном коде событий слоя маркеров HTML.

A screenshot showing a map with a list of HTML marker layer events that are highlighted anytime your actions on the map trigger that event.

В следующей таблице перечислены все поддерживаемые события класса карты.

Мероприятие Description
boxzoomend Возникает при завершении взаимодействия "увеличение поля".
boxzoomstart Возникает при начале взаимодействия "увеличение поля".
click Возникает при нажатии и отпускании указывающего устройства в той же точке на карте.
close Запускается при закрытии всплывающего окна вручную или программно.
contextmenu Возникает при нажатии правой кнопки мыши.
data Возникает при загрузке или изменении данных на карте.
dataadded Возникает при добавлении фигур в DataSource.
dataremoved Возникает при удалении фигур из DataSource.
datasourceupdated Возникает при обновлении объекта DataSource.
dblclick Возникает при двойном нажатии указывающего устройства в той же точке на карте.
drag Возникает повторно во время действия "перетаскивание для сдвига" на карте, всплывающем окне или HTML-метке.
dragend Возникает при завершении действия "перетаскивание для сдвига" на карте, всплывающем окне или HTML-метке.
dragstart Возникает при начале действия "перетаскивание для сдвига" на карте, всплывающем окне или HTML-метке.
error Возникает при возникновении ошибки.
idle

Возникает после отображения последнего кадра до того, как схема переходит в состояние простоя:

  • Нет выполняющихся переходов с камеры.
  • Все запрошенные плитки загружены.
  • Все анимации исчезания/перехода завершены.
keydown Возникает при нажатии клавиши.
keypress При нажатии клавиши, создающей типизированный символ (клавиша ANSI).
keyup Возникает при отпускании клавиши.
layeradded Возникает при добавлении слоя на карту.
layerremoved Возникает при удалении слоя с карты.
load Возникает сразу после загрузки всех необходимых ресурсов и первой полной визуальной отрисовки карты.
mousedown Возникает при нажатии указывающего устройства в карте или поверх элемента.
mouseenter Возникает при первоначальном перемещении указывающего устройства по карте или элементу.
mouseleave Возникает при перемещении указывающего устройства с карты или элемента.
mousemove Возникает при перемещении указывающего устройства по карте или элементу.
mouseout Возникает, когда указывающее устройство покидает холст карты или элемент.
mouseover Возникает при перемещении указывающего устройства на карту или элемент.
mouseup Возникает при отпускании указывающего устройства в карте или поверх элемента.
move Возникает повторно во время анимированного перехода из одного представления в другое в результате взаимодействия с пользователем или методов.
moveend Возникает сразу после завершения перехода карты из одного представления в другое в результате взаимодействия с пользователем или методов.
movestart Возникает непосредственно до начала перехода карты из одного представления в другое в результате взаимодействия с пользователем или методов.
open Запускается при открытии всплывающего окна вручную или программным способом.
pitch Возникает при каждом изменении высоты (наклона) на карте в результате взаимодействия с пользователем или методов.
pitchend Возникает сразу после завершения изменения высоты (наклона) на карте в результате взаимодействия с пользователем или методов.
pitchstart Возникает в начале изменения высоты (наклона) на карте в результате взаимодействия с пользователем или методов.
ready Возникает, когда минимальные необходимые ресурсы карты загружаются, прежде чем карта будет готова к программному взаимодействию.
render

Возникает при каждом отображении карты на экране в результате следующих действий:

  • Изменение расположения, масштаба, высоты или координат на карте.
  • Изменение стиля карты.
  • Изменение источника DataSource.
  • Загрузка плитки вектора, GeoJSON-файла, глифа или спрайта.
resize Возникает сразу после изменения размера карты.
rotate Возникает повторно во время взаимодействия "перетаскивание для поворота".
rotateend Возникает при завершении взаимодействия "перетаскивание для поворота".
rotatestart Возникает при начале взаимодействия "перетаскивание для поворота".
shapechanged Возникает при изменении свойства объекта фигуры.
sourcedata Возникает, когда один из источников карты загружается или изменяется, в том числе когда плитка, принадлежащая источнику, загружается или изменяется.
sourceadded Возникает при добавлении DataSource или VectorTileSource на карту.
sourceremoved Возникает при удалении DataSource или VectorTileSource с карты.
styledata Возникает при загрузке или изменении стиля карты.
styleimagemissing Возникает, когда слой пытается загрузить изображение из спрайта изображения, который не существует
tokenacquired Возникает при получении маркера доступа Microsoft Entra.
touchcancel Возникает, когда в сопоставлении происходит событие touchcancel.
touchend Возникает, когда в сопоставлении происходит событие touchend.
touchmove Возникает, когда в сопоставлении происходит событие touchmove.
touchstart Возникает, когда в сопоставлении происходит событие touchstart.
wheel Возникает, когда на карте происходит событие прокрутки колеса мыши.
zoom Возникает повторно во время анимированного перехода с одного уровня увеличения на другой в результате взаимодействия с пользователем или методов.
zoomend Возникает сразу после завершения перехода карты с одного уровня увеличения на другой в результате взаимодействия с пользователем или методов.
zoomstart Возникает непосредственно до начала перехода карты с одного уровня увеличения на другой в результате взаимодействия с пользователем или методов.

Следующие шаги

Полные примеры кода см. в следующих статьях:

Использование модуля служб Azure Maps

Примеры кода