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

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

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

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

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

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

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

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

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

Мероприятие	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

Примеры кода