你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

处理映像事件

本文介绍如何使用地图事件类。 该属性突出显示地图上以及地图的不同层上的事件。 还可以在与 HTML 标记交互时突出显示事件。

与地图交互

地图事件示例突出显示了与地图交互时触发的事件的名称。 有关此示例的源代码，请参阅映射事件源代码。

与地图层交互

图层事件示例突出显示了与符号图层交互时触发的事件的名称。 符号、气泡、线条和多边形层都支持同一组事件。 热度地图和图块层不支持其中任何事件。 有关此示例的源代码，请参阅图层事件源代码。

与 HTML 标记交互

HTML 标记层事件示例突出显示了与 HTML 标记层交互时触发的事件的名称。 有关此示例的源代码，请参阅 HTML 标记层事件源代码。

下表列出了所有受支持的地图类事件。

事件	说明
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 服务模块

示例代码