Marker

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Marker

google.maps.Marker

此类扩展了 MVCObject

Marker
Marker([opts])
参数
用于创建带有指定选项的标记。如果指定了地图,则标记会在构建时添加到地图中。请注意,您必须设置标记的显示位置。
getAnimation
getAnimation()
参数:无
返回值Animation|null|undefined
获取当前正在运行的动画。
getClickable
getClickable()
参数:无
返回值:如果标记可点击,则为 boolean
获取 Marker 的可点击状态。
getCursor
getCursor()
参数:无
返回值string|null|undefined
获取悬停时显示的鼠标光标类型。
getDraggable
getDraggable()
参数:无
返回值boolean。如果标记是可拖动的,则为 true。
获取 Marker 的可拖动状态。
getIcon
getIcon()
参数:无
返回值string|Icon|null|Symbol|undefined
获取 Marker 的图标。请参阅MarkerOptions.icon
getLabel
getLabel()
参数:无
返回值MarkerLabel|null|string|undefined
获取 Marker 的标签。请参阅MarkerOptions.label
getMap
getMap()
参数:无
获取渲染 Marker 的地图或全景图片。
getOpacity
getOpacity()
参数:无
返回值number|null|undefined 0.0 到 1.0 之间的数字。
获取 Marker 的不透明度。
getPosition
getPosition()
参数:无
返回值LatLng|null|undefined
获取 Marker 的位置。
getShape
getShape()
参数:无
返回值MarkerShape|null|undefined
获取用于互动的 Marker 的形状。请参阅 MarkerOptions.shapeMarkerShape
getTitle
getTitle()
参数:无
返回值string|null|undefined
获取 Marker 提示的标题。请参阅MarkerOptions.title
getVisible
getVisible()
参数:无
返回值boolean。如果标记可见,则为 true。
获取 Marker 的可见性。
getZIndex
getZIndex()
参数:无
返回值number|null|undefined 标记的 zIndex。
获取 Marker 的 zIndex。请参阅MarkerOptions.zIndex
setAnimation
setAnimation([animation])
参数
  • animationAnimation optional 要播放的动画。
返回值:无
启动动画。系统将会取消所有正在播放的动画。目前支持的动画包括:Animation.BOUNCEAnimation.DROP。传入 null 会导致所有动画停止播放。
setClickable
setClickable(flag)
参数
  • flagboolean 如果为 true,则可以点击标记。
返回值:无
设置 Marker 是否可点击。
setCursor
setCursor([cursor])
参数
  • cursorstring optional鼠标光标类型。
返回值:无
设置鼠标悬停时显示的鼠标光标类型。
setDraggable
setDraggable(flag)
参数
  • flagboolean optional 如果为 true,则可拖动标记。
返回值:无
设置 Marker 是否可拖动。
setIcon
setIcon([icon])
参数
返回值:无
设置 Marker 的图标。请参阅MarkerOptions.icon
setLabel
setLabel([label])
参数
返回值:无
设置 Marker 的标签。请参阅MarkerOptions.label
setMap
setMap(map)
参数
返回值:无
在指定的地图或全景上渲染 Marker。如果地图设置为null,该标记将被移除。
setOpacity
setOpacity([opacity])
参数
  • opacitynumber optional 介于 0.0(透明)和 1.0(不透明)之间的数字。
返回值:无
设置 Marker 的不透明度。
setOptions
setOptions(options)
参数
返回值:无
Marker 设置选项。
setPosition
setPosition([latlng])
参数
返回值:无
Marker 设置位置。
setShape
setShape([shape])
参数
返回值:无
设置用于互动的 Marker 的形状。请参阅 MarkerOptions.shapeMarkerShape
setTitle
setTitle([title])
参数
  • titlestring optional
返回值:无
设置 Marker 提示的标题。请参阅MarkerOptions.title
setVisible
setVisible(visible)
参数
  • visibleboolean 如果为 true,则会显示标记
返回值:无
设置 Marker 是否可见。
setZIndex
setZIndex([zIndex])
参数
  • zIndexnumber optional
返回值:无
设置 Marker 的 zIndex。请参阅MarkerOptions.zIndex
继承addListenerbindTogetnotifysetsetValuesunbindunbindAll
MAX_ZINDEX API 分配给标记的最大默认 Z-index。您可以设置较高的 Z-index 值,以使相关标记显示在前面。
animation_changed
function()
参数:None
Marker 动画属性更改时会触发此事件。
click
function(event)
参数
用户点击 Marker 图标时会触发此事件。
clickable_changed
function()
参数:None
Marker 可点击属性发生更改时会触发此事件。
contextmenu
function(event)
参数
Marker 触发 DOM contextmenu 事件时会触发此事件
cursor_changed
function()
参数:None
Marker 光标属性更改时会触发此事件。
dblclick
function(event)
参数
双击 Marker 图标时会触发此事件。
drag
function(event)
参数
当用户拖动 Marker 时,系统会反复触发此事件。
dragend
function(event)
参数
当用户停止拖动 Marker 时会触发此事件。
draggable_changed
function()
参数:None
Marker 可拖动属性更改时会触发此事件。
dragstart
function(event)
参数
用户开始拖动 Marker 时会触发此事件。
flat_changed
function()
参数:None
Marker 平面属性发生更改时会触发此事件。
icon_changed
function()
参数:None
Marker 图标属性更改时会触发此事件。
mousedown
function(event)
参数
Marker 执行鼠标悬停时会触发此事件。
mouseout
function(event)
参数
鼠标离开 Marker 图标的区域时会触发此事件。
mouseover
function(event)
参数
鼠标进入 Marker 图标的区域时会触发此事件。
mouseup
function(event)
参数
Marker 触发鼠标时会触发此事件。
position_changed
function()
参数:None
Marker 位置属性更改时会触发此事件。
shape_changed
function()
参数:None
Marker 形状属性更改时会触发此事件。
title_changed
function()
参数:None
Marker 标题属性更改时会触发此事件。
visible_changed
function()
参数:None
Marker 可见属性更改时会触发此事件。
zindex_changed
function()
参数:None
当 zIndex 的 Marker 属性更改时会触发此事件。
rightclick
function(event)
参数
右键点击 Marker 时会触发此事件。

MarkerOptions 接口

google.maps.MarkerOptions接口

MarkerOptions 对象,用于定义可在 Marker 上设置的属性。

anchorPoint optional
类型Point optional
从标记位置到信息窗口的顶端的偏移量(以标记作为锚点打开)。
animation optional
类型Animation optional
默认null
将标记添加到地图时所播放的动画。
clickable optional
类型boolean optional
默认true
如果为 true,则标记会收到鼠标事件和触摸事件。
BetacollisionBehavior optional
类型string|CollisionBehavior optional
默认null
为矢量地图上的标记设置冲突行为。
crossOnDrag optional
类型boolean optional
默认true
如果为 false,则停用拖动时标记下方显示的叉号。
cursor optional
类型string optional
默认pointer
鼠标悬停时显示的鼠标光标类型。
draggable optional
类型boolean optional
默认false
如果为 true,则可以拖动标记。
icon optional
类型string|Icon|Symbol optional
前景的图标。如果提供字符串,则将其视为字符串为 urlIcon
label optional
类型string|MarkerLabel optional
默认null
向标记添加标签。标记标签是显示在标记内的字母或数字。标签可以是字符串或 MarkerLabel 对象。如果提供了 MarkerOptions.title,但未提供 MarkerOptions.title,则系统会将提供性文字(例如,用于屏幕阅读器的代码)添加到包含所提供标签文字的标记中。请注意,label 目前仅用于未优化标记的无障碍文本。
map optional
类型Map|StreetViewPanorama optional
要在其上显示标记的地图。地图需要显示标记,如果在构建标记时未提供,则可通过 Marker.setMap 来提供地图。
opacity optional
类型number optional
默认:1.0
介于 0.0(透明)和 1.0(不透明)之间的数字。
optimized optional
类型boolean optional
优化可将多个标记渲染为单个静态元素,从而提高性能。在需要大量标记的情况下,这会非常有用。详细了解标记优化
position optional
类型LatLng|LatLngLiteral optional
设置标记位置。您可以构建标记,但在提供其位置之前不会显示标记,例如,根据用户的操作或选择。如果在标记构造时未提供标记位置,则该标记位置可以与 Marker.setPosition 一起提供。
shape optional
类型MarkerShape optional
用于拖动/点击的图像地图区域定义。
title optional
类型string optional
默认undefined
滚动文本。如果提供了无障碍功能文字(例如,与屏幕阅读器搭配使用),则会将该标记添加到所提供的值对应的标记中。请注意,title 目前仅用于未优化标记的无障碍文本。
visible optional
类型boolean optional
默认true
如果为 true,则该标记可见。
zIndex optional
类型number optional
所有标记均按其 zIndex 的顺序在地图上显示,值较大的标记会显示在值较小的标记之前。默认情况下,标记会按照它们在屏幕上的垂直位置来显示,位置较低的标记会显示在位置较高的标记之前。

CollisionBehavior 常量

google.maps.CollisionBehavior 常量

OPTIONAL_AND_HIDES_LOWER_PRIORITY 仅在标记未与其他标记重叠时显示。如果此类型的两个标记相互重叠,则会显示 zIndex 较高的标记。如果它们的 zIndex 相同,则会显示垂直屏幕位置较低的 ZIndex。
REQUIRED 不管有无冲突,一律显示标记。这是默认行为。
REQUIRED_AND_HIDES_OPTIONAL 无论冲突如何,一律显示标记,并隐藏所有与标记重叠的 OPTIONAL_AND_HIDES_LOWER_PRIORITY 标记或标签。

图标界面

google.maps.Icon接口

表示标记图标图片的结构。

url
类型string
图片或拼合图片的网址。
anchor optional
类型Point optional
与标记在地图上的位置相对应的图片锚定位置。默认情况下,锚点会放置在图片底部的中心点附近。
labelOrigin optional
类型Point optional
标签相对于图标图片左上角的来源(如果标记提供了标签)。默认情况下,原点位于图像的中心点。
origin optional
类型Point optional
图片在拼合图片中的位置(如果有的话)。默认情况下,原点位于图片 (0, 0) 的左上角。
scaledSize optional
类型Size optional
进行缩放后的整幅图片的尺寸(如果有的话)。可使用此属性伸展/收缩图片或拼合图片。
size optional
类型Size optional
拼合图片或图片的显示尺寸。使用拼合图片时必须指定其尺寸。如果未提供尺寸,则系统会在加载图片时进行设置。

MarkerLabel 接口

google.maps.MarkerLabel接口

这些选项用于指定标记标签的外观。标记标签是一个字符串(通常是一个字符),它将出现在标记内。如果您将它与自定义标记一起使用,则可以使用 Icon 类中的 labelOrigin 属性来重新定位它。

text
类型string
要在标签中显示的文本。
className optional
类型string optional
默认''(空字符串)
标签元素的 className 属性(等效于元素的类属性)。您可以添加多个以空格分隔的 CSS 类。字体颜色、大小、粗细和系列只能通过 MarkerLabel 的其他属性设置。如果同时使用标记冲突管理,则不应使用 CSS 类更改标签的位置或方向(例如使用平移和旋转)。
color optional
类型string optional
默认'black'
标签文本的颜色。
fontFamily optional
类型string optional
标签文字的字体系列(等同于 CSS 字体系列属性)。
fontSize optional
类型string optional
默认'14px'
标签文字的字体大小(等同于 CSS 字体大小属性)。
fontWeight optional
类型string optional
标签文字的字体粗细(等效于 CSS 字体粗细属性)。

MarkerShape 接口

google.maps.MarkerShape接口

此对象用于定义标记图片的可点击区域。该形状由两个属性(typecoord)组成,用于定义图片的非透明区域。

coords
类型Array<number>
此属性的格式取决于 type 的值,并遵循 http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords 中的 w3 AREA coords 规范。
coords 属性是一个整数数组,指定了形状相对于目标图片左上角的像素位置。坐标取决于 type 的值,如下所示:
- circle:坐标为 [x1,y1,r],其中 x1,y2 是圆心的坐标,r 是圆的半径。
- poly:坐标为 [x1,y1,x2,y2...xn,yn],其中每个 x,y 对分别包含多边形的一个顶点的坐标。
- rect:坐标为 [x1,y1,x2,y2],其中 x1,y1 是矩形左上角的坐标,x2,y2 是矩形右下角的坐标。
type
类型string
描述形状的类型,可以是 circlepolyrect

Symbol 接口

google.maps.Symbol接口

描述符号,它由带样式的矢量路径组成。符号可以用作标记的图标,也可以放置在多段线上。

path
类型SymbolPath|string
符号的路径(内置符号路径),或使用 SVG 路径表示法表示的自定义路径。必需。
anchor optional
类型Point optional
默认google.maps.Point(0,0)
符号相对于标记或多段线的位置。符号路径的坐标分别由锚定点的x坐标和y坐标向左和向上进行转换。位置在与符号路径相同的坐标系中表示。
fillColor optional
类型string optional
符号的填充颜色。支持所有CSS3颜色,扩展命名的颜色除外。对于符号标记,此属性默认为“black”。对于多段线上的符号,这默认为对应多段线的描边颜色。
fillOpacity optional
类型number optional
默认0
符号的填充不透明度。
labelOrigin optional
类型Point optional
默认google.maps.Point(0,0)
相对于路径原点的标签位置(如果标记由标签提供)。原点以与符号路径相同的坐标系表示。此属性不适用于多段线上的符号。
rotation optional
类型number optional
默认0
符号的旋转角度,以顺时针度数表示。IconSequencefixedRotationfalse 的符号会相对于其所在的边缘的角度旋转。
scale optional
类型number optional
符号大小的缩放比例。对于符号标记,默认值为 1;缩放后,符号可为任何大小。对于多段线上的符号,此参数默认为多段线的描边粗细;在缩放后,符号必须位于位于符号锚点中央、大小为 22 像素的方形内。
strokeColor optional
类型string optional
符号的描边颜色。支持所有CSS3颜色,扩展命名的颜色除外。对于符号标记,此属性默认为“black”。对于多段线上的符号,此参数默认为多段线的描边颜色。
strokeOpacity optional
类型number optional
符号的描边不透明度。对于符号标记,默认值为 1。对于多段线上的符号,此参数默认为多段线的描边不透明度。
strokeWeight optional
类型number optional
默认:符号的 Symbol.scale
符号的笔触粗细。

SymbolPath 常量

google.maps.SymbolPath 常量

内置符号路径。

BACKWARD_CLOSED_ARROW 一个向后指的闭合箭头。
BACKWARD_OPEN_ARROW 一个向后指的开放式箭头。
CIRCLE 圆形。
FORWARD_CLOSED_ARROW 指向前方的闭合箭头。
FORWARD_OPEN_ARROW 一把向前开放的箭头。

动画常量

google.maps.Animation 常量

可以在标记上播放的动画。对标记使用 Marker.setAnimation 方法,或使用 MarkerOptions.animation 选项播放动画。

BOUNCE 在动画停止播放之前,标记会使用 null 调用 Marker.setAnimation
DROP 标记会从地图顶部拖放到其最终位置。动画将会随着标记的停止而停止,Marker.getAnimation 将返回 null。这种动画通常是在创建标记的过程中指定的。