Advanced Markers (beta)

AdvancedMarkerView

google.maps.marker.AdvancedMarkerView

使用指定的选项创建 AdvancedMarkerView。如果指定了地图,AdvancedMarkerView 会在构建时添加到地图中。请注意,必须设置位置才能显示 AdvancedMarkerView

此类实现 AdvancedMarkerViewOptions

需要 &libraries=marker 网址参数。请参阅 Maps JavaScript API 中的库

AdvancedMarkerView
AdvancedMarkerView([options])
参数
collisionBehavior
类型CollisionBehavior optional
content
类型Element optional
draggable
类型boolean optional
element optional
类型Element optional
此字段为只读字段。支持视图的 DOM 元素。
map
类型Map optional
position
title
类型string optional
zIndex
类型number optional
addListener
addListener(eventName, handler)
参数
返回值MapsEventListener
将给定的监听器函数添加到给定的事件名称。
click
function(event)
参数
当用户点击 AdvancedMarkerView 元素时会触发此事件。
drag
function(event)
参数
当用户拖动 AdvancedMarkerView 时,系统会反复触发此事件。
dragend
function(event)
参数
当用户停止拖动 AdvancedMarkerView 时会触发此事件。
dragstart
function(event)
参数
当用户开始拖动 AdvancedMarkerView 时会触发此事件。

AdvancedMarkerViewOptions 接口

google.maps.marker.AdvancedMarkerViewOptions接口

用于构建 AdvancedMarkerView 的选项。

需要 &libraries=marker 网址参数。请参阅 Maps JavaScript API 中的库

collisionBehavior optional
类型CollisionBehavior optional
一个枚举,用于指定 AdvancedMarkerView 在与其他 AdvancedMarkerView 或矢量地图上的基本地图标签发生冲突时的行为方式。

注意AdvancedMarkerViewAdvancedMarkerView 冲突适用于光栅和矢量地图,但 AdvancedMarkerView 与基本地图的标签冲突仅适用于矢量地图。

content optional
类型Element optional
支持 AdvancedMarkerView 视觉元素的 DOM 元素。

注意AdvancedMarkerView 不会克隆传入的 DOM 元素。将 DOM 元素传递给 AdvancedMarkerView 后,如果将同一 DOM 元素传递给另一个 AdvancedMarkerView,就会移动 DOM 元素,并使之前的 AdvancedMarkerView 看起来为空。

draggable optional
类型boolean optional
默认false
如果为 true,则可以拖动 AdvancedMarkerView

注意:包含高度的 AdvancedMarkerView 不可拖动。

element optional
类型Element optional
此字段为只读字段。支持视图的 DOM 元素。
map optional
类型Map optional
要在其上显示 AdvancedMarkerView 的地图。地图是显示AdvancedMarkerView的必要条件;如果在构建时未提供,可以通过设置AdvancedMarkerView.map来提供。
position optional
设置 AdvancedMarkerView 的位置。AdvancedMarkerView 可以在没有位置的情况下构造,但只有在提供其位置后才会显示(例如,通过用户的操作或选择)。如果在构建时未提供 AdvancedMarkerView,可以通过设置 AdvancedMarkerView.position 来提供位置。

注意:仅矢量地图支持包含高度的 AdvancedMarkerView

title optional
类型string optional
鼠标悬停时显示的文字。如果提供无障碍文本(例如与屏幕阅读器结合使用),系统会使用提供的值将其添加到 AdvancedMarkerView 中。
zIndex optional
类型number optional
所有 AdvancedMarkerView 都按其 zIndex 的顺序显示在地图上,值较高的 AdvancedMarkerView 会显示在值较低的 AdvancedMarkerView 前面。默认情况下,AdvancedMarkerView 会根据其在屏幕上的垂直位置显示,较低的 AdvancedMarkerView 会显示在更靠后的 AdvancedMarkerView 前面。请注意,zIndex 还有助于确定 CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY 高级标记之间的相对优先级。zIndex 值越高,表示优先级越高。

PinView

google.maps.marker.PinView

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

此类实现 PinViewOptions

需要 &libraries=marker 网址参数。请参阅 Maps JavaScript API 中的库

PinView
PinView([options])
参数
background
类型string optional
borderColor
类型string optional
element optional
类型Element optional
此字段为只读字段。支持视图的 DOM 元素。
glyph
类型string|Element|URL optional
glyphColor
类型string optional
scale
类型number optional
addListener
addListener(eventName, handler)
参数
返回值MapsEventListener
将给定的监听器函数添加到给定的事件名称。

PinViewOptions 接口

google.maps.marker.PinViewOptions接口

用于创建 PinView 的选项。

需要 &libraries=marker 网址参数。请参阅 Maps JavaScript API 中的库

background optional
类型string optional
图钉形状的背景颜色。支持任何 CSS 颜色值
borderColor optional
类型string optional
图钉形状的边框颜色。支持任何 CSS 颜色值
element optional
类型Element optional
此字段为只读字段。支持视图的 DOM 元素。
glyph optional
类型string|Element|URL optional
PIN 码中显示的 DOM 元素。
glyphColor optional
类型string optional
字形的颜色。支持任何 CSS 颜色值
scale optional
类型number optional
默认1
图钉的缩放比例。