Advanced Markers

AdvancedMarkerElement 类

google.maps.marker.AdvancedMarkerElement 类

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

注意：作为 Web 组件使用（例如，只能在 v=beta 渠道中使用自定义 <gmp-advanced-marker> HTML 元素）。

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

此类扩展了 HTMLElement。

此类会实现 AdvancedMarkerElementOptions。

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

构造函数
AdvancedMarkerElement	AdvancedMarkerElement([options]) 参数： options：AdvancedMarkerElementOptions optional 使用指定选项创建 AdvancedMarkerElement。如果指定了地图，系统会在构造时向地图添加 AdvancedMarkerElement。

属性
collisionBehavior	类型：CollisionBehavior optional 请参阅AdvancedMarkerElementOptions.collisionBehavior。
content	类型：Node optional 请参阅AdvancedMarkerElementOptions.content。
element	类型：HTMLElement 此字段是只读字段。支持视图的 DOM 元素。
gmpClickable	注意：仅适用于 v=beta 渠道。 类型：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	注意：仅适用于 v=beta 渠道。 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 生成的事件监听器。 将指定监听器函数添加到地图事件系统中的指定事件名称。
removeEventListener	注意：仅适用于 v=beta 渠道。 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	注意：仅适用于 v=beta 渠道。 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	注意：仅适用于 v=beta 渠道。 类型：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 类

注意：仅适用于 v=beta 渠道。

此事件是通过点击高级标记创建的。通过 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 中的库。

构造函数
PinElement	PinElement([options]) 参数： options：PinElementOptions optional

属性
background	类型：string optional 请参阅PinElementOptions.background。
borderColor	类型：string optional 请参阅PinElementOptions.borderColor。
element	类型：HTMLElement 此字段是只读字段。支持视图的 DOM 元素。
glyph	类型：string|Element|URL optional 请参阅PinElementOptions.glyph。
glyphColor	类型：string optional 请参阅PinElementOptions.glyphColor。
scale	类型：number optional 请参阅PinElementOptions.scale。

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

PinElementOptions 接口

google.maps.marker.PinElementOptions 接口

用于创建 PinElement 的选项。

属性
background optional	类型：string optional 图钉形状的背景颜色。支持任何 CSS 颜色值。
borderColor optional	类型：string optional 图钉形状的边框颜色。支持任何 CSS 颜色值。
glyph optional	类型：string|Element|URL optional 图钉中显示的 DOM 元素。
glyphColor optional	类型：string optional 字形的颜色。支持任何 CSS 颜色值。
scale optional	类型：number optional 默认值：1 图钉的缩放比例。