Advanced Markers

AdvancedMarkerElement 类

google.maps.marker.AdvancedMarkerElement 类

在地图上显示位置。请注意，必须设置 position，AdvancedMarkerElement 才能显示。

注意：作为 Web 组件（例如使用自定义 <gmp-advanced-marker> HTML 元素）的用法仅适用于 v=beta 渠道。

自定义元素：
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

此类扩展了 HTMLElement。

此类实现了 AdvancedMarkerElementOptions。

通过调用 const {AdvancedMarkerElement} = await google.maps.importLibrary("marker") 进行访问。
请参阅 Maps JavaScript API 中的库。

属性
collisionBehavior	类型：  CollisionBehavior optional 请参阅 AdvancedMarkerElementOptions.collisionBehavior。
content	类型：  Node optional 请参阅 AdvancedMarkerElementOptions.content。
element	类型：  HTMLElement 此字段为只读字段。支持视图的 DOM 元素。
gmpClickable	类型：  boolean optional 请参阅 AdvancedMarkerElementOptions.gmpClickable。
gmpDraggable	类型：  boolean optional 请参阅 AdvancedMarkerElementOptions.gmpDraggable。
map	类型：  Map optional 请参阅 AdvancedMarkerElementOptions.map。
position	类型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 请参阅 AdvancedMarkerElementOptions.position。 HTML 属性： <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	类型：  string 请参阅 AdvancedMarkerElementOptions.title。 HTML 属性： <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	类型：  number optional 请参阅 AdvancedMarkerElementOptions.zIndex。

方法
addEventListener	addEventListener(type, listener[, options]) 参数：  type：string一个区分大小写的字符串，表示要监听的事件类型。 listener：EventListener|EventListenerObject 接收通知的对象。必须是函数或具有 handleEvent 方法的对象 options：boolean|AddEventListenerOptions optional 请参阅选项。自定义事件仅支持 capture 和 passive。 返回值：  void 设置一个函数，每当指定事件传递到目标时，系统都会调用该函数。请参阅 addEventListener
addListener	addListener(eventName, handler) 参数：  eventName：string观测到的事件。 handler：Function 用于处理事件的函数。 返回值：生成的事件监听器。MapsEventListener 在 Maps Eventing 系统中，将指定的监听器函数添加到指定的事件名称。
removeEventListener	removeEventListener(type, listener[, options]) 参数：  type：string 一个字符串，用于指定要移除事件监听器的事件类型。 listener：EventListener|EventListenerObject 要从事件目标中移除的事件处理脚本的事件监听器。 options：boolean|EventListenerOptions optional 请参阅选项。 返回值：  void 从目标中移除之前通过 addEventListener 注册的事件监听器。请参阅 removeEventListener。

事件
click	function(event) 实参：  event：MapMouseEvent 当点击 AdvancedMarkerElement 元素时，系统会触发此事件。 不适用于 addEventListener()（请改用 gmp-click）。
drag	function(event) 实参：  event：MapMouseEvent 在用户拖动 AdvancedMarkerElement 时，此事件会反复触发。 不适用于 addEventListener()。
dragend	function(event) 实参：  event：MapMouseEvent 当用户停止拖动 AdvancedMarkerElement 时，系统会触发此事件。 不适用于 addEventListener()。
dragstart	function(event) 实参：  event：MapMouseEvent 当用户开始拖动 AdvancedMarkerElement 时，系统会触发此事件。 不适用于 addEventListener()。
gmp-click	function(event) 实参：  event：AdvancedMarkerClickEvent 当点击 AdvancedMarkerElement 元素时，系统会触发此事件。最好与 addEventListener()（而非 addListener()）搭配使用。

AdvancedMarkerElementOptions 接口

google.maps.marker.AdvancedMarkerElementOptions 接口

用于构建 AdvancedMarkerElement 的选项。

属性
collisionBehavior optional	类型：  CollisionBehavior optional 一种枚举，用于指定 AdvancedMarkerElement 在与另一个 AdvancedMarkerElement 或矢量地图上的基本地图标签发生冲突时的行为方式。 注意：AdvancedMarkerElement 与 AdvancedMarkerElement 之间的冲突检测适用于光栅地图和矢量地图，但 AdvancedMarkerElement 与基本地图标签之间的冲突检测仅适用于矢量地图。
content optional	类型：  Node optional 默认值： PinElement.element 支持 AdvancedMarkerElement 视觉效果的 DOM 元素。 注意：AdvancedMarkerElement 不会克隆传入的 DOM 元素。将 DOM 元素传递给 AdvancedMarkerElement 后，如果将同一 DOM 元素传递给另一个 AdvancedMarkerElement，则会移动该 DOM 元素，并导致之前的 AdvancedMarkerElement 看起来为空。
gmpClickable optional	类型：  boolean optional 默认值： false 如果为 true，AdvancedMarkerElement 将可以点击，并会触发 gmp-click 事件，还可以进行互动以实现无障碍功能（例如，允许通过箭头键进行键盘导航）。
gmpDraggable optional	类型：  boolean optional 默认值： false 如果为 true，则可以拖动 AdvancedMarkerElement。 注意：带有海拔高度的 AdvancedMarkerElement 不可拖动。
map optional	类型：  Map optional 要在其上显示 AdvancedMarkerElement 的地图。地图是显示 AdvancedMarkerElement 所必需的，如果未在构建时提供，则可以通过设置 AdvancedMarkerElement.map 来提供。
position optional	类型：  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 设置 AdvancedMarkerElement 的位置。AdvancedMarkerElement 可以不带位置信息进行构建，但在提供位置信息之前（例如，通过用户的操作或选择）不会显示。如果未在构建时提供 AdvancedMarkerElement 的位置，则可以通过设置 AdvancedMarkerElement.position 来提供。 注意：带海拔高度的 AdvancedMarkerElement 仅在矢量地图上受支持。
title optional	类型：  string optional 鼠标悬停时显示的文本。如果提供，则会向 AdvancedMarkerElement 添加无障碍文本（例如，用于屏幕阅读器），并使用提供的值。
zIndex optional	类型：  number optional 所有 AdvancedMarkerElement 均按照其 zIndex 的顺序显示在地图上，值较高的 AdvancedMarkerElement 会显示在值较低的 AdvancedMarkerElement 前面。默认情况下，系统会根据 AdvancedMarkerElement 在屏幕上的纵向位置显示它们，位置较低的 AdvancedMarkerElement 会显示在位置较高的 AdvancedMarkerElement 前面。请注意，zIndex 还用于帮助确定 CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY 高级标记之间的相对优先级。zIndex 值越高，表示优先级越高。

AdvancedMarkerClickEvent 类

google.maps.marker.AdvancedMarkerClickEvent 类

此事件是在点击高级标记时创建的。使用 event.target.position 访问标记的位置。

此类扩展了 Event。

通过调用 const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker") 进行访问。
请参阅 Maps JavaScript API 中的库。

PinElement 类

google.maps.marker.PinElement 类

PinElement 表示由形状和字形组成的 DOM 元素。该形状具有与默认 AdvancedMarkerElement 中相同的气球样式。字形是显示在气球形状中的可选 DOM 元素。PinElement 的宽高比可能会因其PinElement.scale而异。

注意：尚不支持作为 Web 组件使用（例如，作为 HTMLElement 子类使用或通过 HTML 使用）。

此类扩展了 HTMLElement。

此类实现了 PinElementOptions。

通过调用 const {PinElement} = await google.maps.importLibrary("marker") 进行访问。
请参阅 Maps JavaScript API 中的库。

方法
addEventListener	addEventListener(type, listener[, options]) 参数：  type：string listener：EventListener|EventListenerObject options：boolean|AddEventListenerOptions optional 返回值：  void 此功能尚无法使用。
removeEventListener	removeEventListener(type, listener[, options]) 参数：  type：string 一个字符串，用于指定要移除事件监听器的事件类型。 listener：EventListener|EventListenerObject 要从事件目标中移除的事件处理脚本的事件监听器。 options：boolean|EventListenerOptions optional 请参阅选项。 返回值：  void 从目标中移除之前通过 addEventListener 注册的事件监听器。请参阅 removeEventListener。

PinElementOptions 接口

google.maps.marker.PinElementOptions 接口

用于创建 PinElement 的选项。