Polygons

Polyline 类

google.maps.Polyline 类

折线是地图上的连接线段的线性叠加层。

此类扩展了 MVCObject。

通过调用 const {Polyline} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。
Polyline
Polyline([opts])
参数： 
使用传递的 PolylineOptions 创建多段线，该参数指定了多段线的路径以及绘制多段线时要使用的笔触样式。在构建多段线时，您可以传递 LatLng 数组或 LatLng 的 MVCArray，不过简单数组在实例化时会转换为多段线内的 MVCArray。
getDraggable
getDraggable()
参数：无
返回值：  boolean
返回相应形状是否可供用户拖动。
getEditable
getEditable()
参数：无
返回值：  boolean
返回用户是否可以修改此形状。
getMap
getMap()
参数：无
返回值：  Map|null
返回此形状所附加到的地图。
getPath
getPath()
参数：无
返回值：  MVCArray<LatLng>
检索路径。
getVisible
getVisible()
参数：无
返回值：  boolean
返回相应多边形在地图上是否可见。
setDraggable
setDraggable(draggable)
参数： 
  • draggable：boolean
返回值：无
如果设置为 true，用户可以在地图上拖动此形状。geodesic 属性用于定义拖动模式。
setEditable
setEditable(editable)
参数： 
  • editable：boolean
返回值：无
如果设置为 true，用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：无
在指定地图上渲染此形状。如果将地图设置为 null，则会移除相应形状。
setOptions
setOptions(options)
参数： 
返回值：无
setPath
setPath(path)
参数： 
返回值：无
设置路径。如需了解详情，请参阅 PolylineOptions。
setVisible
setVisible(visible)
参数： 
  • visible：boolean
返回值：无
如果设置为 false，则隐藏此多边形。
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
click
function(event)
实参： 
对折线触发 DOM click 事件时会触发此事件。
contextmenu
function(event)
实参： 
当在折线上触发 DOM contextmenu 事件时，会触发此事件。
dblclick
function(event)
实参： 
对折线触发 DOM dblclick 事件时会触发此事件。
drag
function(event)
实参： 
在用户拖动折线时，此事件会反复触发。
dragend
function(event)
实参： 
当用户停止拖动折线时触发此事件。
dragstart
function(event)
实参： 
当用户开始拖动折线时触发此事件。
mousedown
function(event)
实参： 
对折线触发 DOM mousedown 事件时会触发此事件。
mousemove
function(event)
实参： 
对折线触发 DOM mousemove 事件时会触发此事件。
mouseout
function(event)
实参： 
此事件针对折线 mouseout 触发。
mouseover
function(event)
实参： 
此事件针对折线 mouseover 触发。
mouseup
function(event)
实参： 
对折线触发 DOM mouseup 事件时会触发此事件。
rightclick
function(event)
实参： 
右键点击折线时会触发此事件。

PolylineOptions 接口

google.maps.PolylineOptions 接口

用于定义可在 Polyline 上设置的属性的 PolylineOptions 对象。
clickable optional
类型：  boolean optional
默认值： true
指示此 Polyline 是否处理鼠标事件。
draggable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以在地图上拖动此形状。geodesic 属性用于定义拖动模式。
editable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。
geodesic optional
类型：  boolean optional
默认值： false
如果值为 true，则多边形的边会被解读为测地线，并会遵循地球的曲率。当值为 false 时，多边形的边在屏幕空间中渲染为直线。请注意，测地多边形的形状在拖动时可能会发生变化，因为其尺寸是相对于地球表面保持不变的。
icons optional
类型：  Array<IconSequence> optional
要沿多段线渲染的图标。
map optional
类型：  Map optional
要在其上显示折线的地图。
path optional
类型：  MVCArray<LatLng>|Array<LatLng|LatLngLiteral> optional
折线坐标的有序序列。可以使用简单的 LatLng 数组或 LatLng 的 MVCArray 来指定此路径。请注意，如果您传递的是一个简单数组，系统会将其转换为 MVCArray。在 MVCArray 中插入或移除 LatLng 会自动更新地图上的多段线。
strokeColor optional
类型：  string optional
笔触颜色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
strokeOpacity optional
类型：  number optional
笔触透明度，范围为 0.0 到 1.0。
strokeWeight optional
类型：  number optional
笔触宽度（以像素为单位）。
visible optional
类型：  boolean optional
默认值： true
相应多段线在地图上是否可见。
zIndex optional
类型：  number optional
相对于其他折线的 zIndex。

IconSequence 接口

google.maps.IconSequence 接口

描述如何在行上呈现图标。

如果您的多段线为测地线，则默认以米为单位计算为偏移和重复指定的距离。如果将偏移或重复设置为像素值，则系统会以屏幕上的像素为单位计算距离。
fixedRotation optional
类型：  boolean optional
默认值： false
如果值为 true，则序列中的每个图标都具有相同的固定旋转角度，无论它位于哪个边的角度。如果为 false，则会旋转序列中的每个图标，使其与边缘对齐。
icon optional
类型：  Symbol optional
要在相应行上呈现的图标。
offset optional
类型：  string optional
默认值： '100%'
图标的渲染位置距线条起点的距离。该距离可以线条长度百分比（例如“50%”）或像素（例如“50 像素”）表示。
repeat optional
类型：  string optional
默认值： 0
线条上连续图标的间距。该距离可以线条长度百分比（例如“50%”）或像素（例如“50 像素”）表示。若要停用图标重复，请指定“0”。

Polygon 类

google.maps.Polygon 类

多边形（如多段线）定义了一系列按顺序排列的相连坐标。此外，多边形会形成闭合环路并定义填充区域。请参阅开发者指南中的示例，从简单多边形、带孔的多边形等开始。请注意，您还可以使用数据层创建多边形。数据图层提供了一种更简单的创建孔洞的方式，因为它会为您处理内外侧路径的顺序。

此类扩展了 MVCObject。

通过调用 const {Polygon} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。
Polygon
Polygon([opts])
参数： 
使用传递的 PolygonOptions 创建一个多边形，该参数用于指定多边形的路径、多边形边缘的描边样式以及多边形内部区域的填充样式。一个多边形可以包含一条或多条路径，其中每条路径都由一个 LatLng 数组组成。构造这些路径时，您可以传递 LatLng 数组或 LatLng 的 MVCArray。在实例化时，数组会转换为多边形内的 MVCArray。
getDraggable
getDraggable()
参数：无
返回值：  boolean
返回相应形状是否可供用户拖动。
getEditable
getEditable()
参数：无
返回值：  boolean
返回用户是否可以修改此形状。
getMap
getMap()
参数：无
返回值：  Map|null
返回此形状所附加到的地图。
getPath
getPath()
参数：无
返回值：  MVCArray<LatLng>
检索第一条路径。
getPaths
getPaths()
参数：无
返回值：  MVCArray<MVCArray<LatLng>>
检索相应多边形的路径。
getVisible
getVisible()
参数：无
返回值：  boolean
返回相应多边形在地图上是否可见。
setDraggable
setDraggable(draggable)
参数： 
  • draggable：boolean
返回值：无
如果设置为 true，用户可以在地图上拖动此形状。geodesic 属性用于定义拖动模式。
setEditable
setEditable(editable)
参数： 
  • editable：boolean
返回值：无
如果设置为 true，用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：无
在指定地图上渲染此形状。如果将地图设置为 null，则会移除相应形状。
setOptions
setOptions(options)
参数： 
返回值：无
setPath
setPath(path)
参数： 
返回值：无
设置第一条路径。如需了解详情，请参阅 PolygonOptions。
setPaths
setPaths(paths)
参数： 
返回值：无
为此多边形设置路径。
setVisible
setVisible(visible)
参数： 
  • visible：boolean
返回值：无
如果设置为 false，则隐藏此多边形。
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
click
function(event)
实参： 
对多边形触发 DOM click 事件时会触发此事件。
contextmenu
function(event)
实参： 
当在多边形上触发 DOM contextmenu 事件时，系统会触发此事件。
dblclick
function(event)
实参： 
对多边形触发 DOM dblclick 事件时会触发此事件。
drag
function(event)
实参： 
在用户拖动多边形时，此事件会反复触发。
dragend
function(event)
实参： 
当用户停止拖动多边形时触发此事件。
dragstart
function(event)
实参： 
当用户开始拖动多边形时触发此事件。
mousedown
function(event)
实参： 
对多边形触发 DOM mousedown 事件时会触发此事件。
mousemove
function(event)
实参： 
对多边形触发 DOM mousemove 事件时会触发此事件。
mouseout
function(event)
实参： 
此事件针对多边形 mouseout 触发。
mouseover
function(event)
实参： 
此事件针对多边形 mouseover 触发。
mouseup
function(event)
实参： 
对多边形触发 DOM mouseup 事件时会触发此事件。
rightclick
function(event)
实参： 
右键点击多边形时会触发此事件。

PolygonOptions 接口

google.maps.PolygonOptions 接口

用于定义可在多边形上设置的属性的 PolygonOptions 对象。
clickable optional
类型：  boolean optional
默认值： true
指示此 Polygon 是否处理鼠标事件。
draggable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以在地图上拖动此形状。geodesic 属性用于定义拖动模式。
editable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。
fillColor optional
类型：  string optional
填充色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
fillOpacity optional
类型：  number optional
介于 0.0 和 1.0 之间的填充不透明度
geodesic optional
类型：  boolean optional
默认值： false
如果值为 true，则多边形的边会被解读为测地线，并会遵循地球的曲率。当值为 false 时，多边形的边在屏幕空间中渲染为直线。请注意，测地多边形的形状在拖动时可能会发生变化，因为其尺寸是相对于地球表面保持不变的。
map optional
类型：  Map optional
要在其上显示多边形的地图。
paths optional
用于指定闭合环的坐标的有序序列。不同于折线，一个多边形由一条或多条路径组成。因此，paths 属性可能会指定一个或多个 LatLng 坐标数组。路径会自动闭合；请勿将路径的第一个顶点重复用作最后一个顶点。可以使用单个 LatLng 数组来定义简单多边形。更复杂的多边形可以指定数组的数组。所有简单数组都会转换为 MVCArray。在 MVCArray 中插入或移除 LatLng 会自动更新地图上的多边形。
strokeColor optional
类型：  string optional
笔触颜色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
strokeOpacity optional
类型：  number optional
介于 0.0 和 1.0 之间的笔触不透明度
strokePosition optional
类型：  StrokePosition optional
默认值： StrokePosition.CENTER
笔画位置。
strokeWeight optional
类型：  number optional
笔触宽度（以像素为单位）。
visible optional
类型：  boolean optional
默认值： true
相应多边形在地图上是否可见。
zIndex optional
类型：  number optional
相对于其他折线的 zIndex。

PolyMouseEvent 接口

google.maps.PolyMouseEvent 接口

此对象是从多段线和多边形上的鼠标事件返回的。

此接口扩展了 MapMouseEvent。

edge optional
类型：  number optional
如果事件发生在可修改多边形的中点，则为事件发生时鼠标悬停的路径中边的索引。
path optional
类型：  number optional
如果事件发生在顶点上且多边形可修改，则为事件发生时鼠标下方路径的索引。否则为 undefined。
vertex optional
类型：  number optional
如果事件发生在顶点上，并且多段线或多边形可编辑，则为事件发生时光标下方的顶点的索引。如果事件未发生在顶点上，则值为 undefined。
继承自： domEvent、 latLng
继承自： stop

Rectangle 类

google.maps.Rectangle 类

矩形叠加层。

此类扩展了 MVCObject。

通过调用 const {Rectangle} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。
Rectangle
Rectangle([opts])
参数： 
使用传递的 RectangleOptions 创建一个矩形，该参数用于指定边界和样式。
getBounds
getBounds()
参数：无
返回值：  LatLngBounds|null
传回此矩形的范围。
getDraggable
getDraggable()
参数：无
返回值：  boolean
返回用户是否可以拖动此矩形。
getEditable
getEditable()
参数：无
返回值：  boolean
返回用户是否可以修改此矩形。
getMap
getMap()
参数：无
返回值：  Map|null
传回显示此矩形的地图。
getVisible
getVisible()
参数：无
返回值：  boolean
返回相应矩形是否在地图上可见。
setBounds
setBounds(bounds)
参数： 
返回值：无
设置此矩形的范围。
setDraggable
setDraggable(draggable)
参数： 
  • draggable：boolean
返回值：无
如果设置为 true，用户可以在地图上拖动此矩形。
setEditable
setEditable(editable)
参数： 
  • editable：boolean
返回值：无
如果设置为 true，用户可以通过拖动显示在各个角和每条边上的控制点来修改此矩形。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：无
在指定地图上渲染此矩形。如果将地图设置为 null，则系统会移除矩形。
setOptions
setOptions(options)
参数： 
返回值：无
setVisible
setVisible(visible)
参数： 
  • visible：boolean
返回值：无
如果设置为 false，则隐藏此矩形。
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
bounds_changed
function()
参数：None
当矩形的边界发生变化时，会触发此事件。
click
function(event)
实参： 
当在矩形上触发 DOM 点击事件时，会触发此事件。
contextmenu
function(event)
实参： 
当在矩形上触发 DOM contextmenu 事件时，会触发此事件。
dblclick
function(event)
实参： 
当在矩形上触发 DOM dblclick 事件时，会触发此事件。
drag
function(event)
实参： 
在用户拖动矩形时，此事件会反复触发。
dragend
function(event)
实参： 
当用户停止拖动矩形时触发此事件。
dragstart
function(event)
实参： 
当用户开始拖动矩形时触发此事件。
mousedown
function(event)
实参： 
当在矩形上触发 DOM mousedown 事件时，会触发此事件。
mousemove
function(event)
实参： 
当在矩形上触发 DOM mousemove 事件时，会触发此事件。
mouseout
function(event)
实参： 
此事件在矩形鼠标移出时触发。
mouseover
function(event)
实参： 
此事件在矩形鼠标悬停时触发。
mouseup
function(event)
实参： 
当在矩形上触发 DOM mouseup 事件时，会触发此事件。
rightclick
function(event)
实参： 
当用户右键点击矩形时，系统会触发此事件。

RectangleOptions 接口

google.maps.RectangleOptions 接口

用于定义可在 Rectangle 上设置的属性的 RectangleOptions 对象。
bounds optional
类型：  LatLngBounds|LatLngBoundsLiteral optional
范围。
clickable optional
类型：  boolean optional
默认值： true
指示此 Rectangle 是否处理鼠标事件。
draggable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以在地图上拖动此矩形。
editable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以通过拖动显示在各个角和每条边上的控制点来修改此矩形。
fillColor optional
类型：  string optional
填充色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
fillOpacity optional
类型：  number optional
介于 0.0 和 1.0 之间的填充不透明度
map optional
类型：  Map optional
要在其上显示矩形的地图。
strokeColor optional
类型：  string optional
笔触颜色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
strokeOpacity optional
类型：  number optional
介于 0.0 和 1.0 之间的笔触不透明度
strokePosition optional
类型：  StrokePosition optional
默认值： StrokePosition.CENTER
笔画位置。
strokeWeight optional
类型：  number optional
笔触宽度（以像素为单位）。
visible optional
类型：  boolean optional
默认值： true
相应矩形是否在地图上显示。
zIndex optional
类型：  number optional
相对于其他折线的 zIndex。

Circle 类

google.maps.Circle 类

地球表面上的一个圆；也称为“球面帽”。

此类扩展了 MVCObject。

通过调用 const {Circle} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。
Circle
Circle([circleOrCircleOptions])
参数： 
使用传递的 CircleOptions 创建一个圆，该对象指定了圆心、半径和样式。
getBounds
getBounds()
参数：无
返回值：  LatLngBounds|null
获取相应圆的 LatLngBounds。
getCenter
getCenter()
参数：无
返回值：  LatLng|null
传回此圆的中心。
getDraggable
getDraggable()
参数：无
返回值：  boolean
返回用户是否可以拖动此圆圈。
getEditable
getEditable()
参数：无
返回值：  boolean
返回用户是否可以修改此圆圈。
getMap
getMap()
参数：无
返回值：  Map|null
传回在其上显示此圆的地图。
getRadius
getRadius()
参数：无
返回值：  number
传回此圆的半径（以米为单位）。
getVisible
getVisible()
参数：无
返回值：  boolean
返回相应圆圈是否在地图上可见。
setCenter
setCenter(center)
参数： 
返回值：无
设置此圆的中心。
setDraggable
setDraggable(draggable)
参数： 
  • draggable：boolean
返回值：无
如果设置为 true，用户可以在地图上拖动此圆圈。
setEditable
setEditable(editable)
参数： 
  • editable：boolean
返回值：无
如果设置为 true，用户可以通过拖动显示在圆心和圆周周围的控制点来修改此圆。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：无
在指定地图上渲染此圆。如果将地图设置为 null，则会移除圆圈。
setOptions
setOptions(options)
参数： 
返回值：无
setRadius
setRadius(radius)
参数： 
  • radius：number
返回值：无
设置此圆的半径（以米为单位）。
setVisible
setVisible(visible)
参数： 
  • visible：boolean
返回值：无
如果设置为 false，则隐藏此圆圈。
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
center_changed
function()
参数：None
当圆的中心发生变化时，会触发此事件。
click
function(event)
实参： 
当在圆上触发 DOM 点击事件时，会触发此事件。
dblclick
function(event)
实参： 
当在圆上触发 DOM dblclick 事件时，会触发此事件。
drag
function(event)
实参： 
在用户拖动圆圈时，此事件会反复触发。
dragend
function(event)
实参： 
当用户停止拖动圆圈时触发此事件。
dragstart
function(event)
实参： 
当用户开始拖动圆圈时触发此事件。
mousedown
function(event)
实参： 
当在圆上触发 DOM mousedown 事件时，会触发此事件。
mousemove
function(event)
实参： 
当在圆上触发 DOM mousemove 事件时，会触发此事件。
mouseout
function(event)
实参： 
此事件在圆形鼠标移出时触发。
mouseover
function(event)
实参： 
此事件在鼠标悬停在圆圈上时触发。
mouseup
function(event)
实参： 
当在圆上触发 DOM mouseup 事件时，系统会触发此事件。
radius_changed
function()
参数：None
当圆的半径发生变化时，会触发此事件。
rightclick
function(event)
实参： 
当用户右键点击圆圈时，系统会触发此事件。

CircleOptions 接口

google.maps.CircleOptions 接口

用于定义可在 Circle 上设置的属性的 CircleOptions 对象。
center optional
类型：  LatLng|LatLngLiteral optional
圆的中心。
clickable optional
类型：  boolean optional
默认值： true
指示此 Circle 是否处理鼠标事件。
draggable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以在地图上拖动此圆圈。
editable optional
类型：  boolean optional
默认值： false
如果设置为 true，用户可以通过拖动显示在圆心和圆周周围的控制点来修改此圆。
fillColor optional
类型：  string optional
填充色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
fillOpacity optional
类型：  number optional
填充透明度，范围为 0.0 到 1.0。
map optional
类型：  Map optional
要在其上显示圆圈的地图。
radius optional
类型：  number optional
地球表面的半径（以米为单位）。
strokeColor optional
类型：  string optional
笔触颜色。支持所有 CSS3 颜色，扩展的已命名颜色除外。
strokeOpacity optional
类型：  number optional
笔触透明度，范围为 0.0 到 1.0。
strokePosition optional
类型：  StrokePosition optional
默认值： StrokePosition.CENTER
笔画位置。
strokeWeight optional
类型：  number optional
笔触宽度（以像素为单位）。
visible optional
类型：  boolean optional
默认值： true
相应圆圈在地图上是否可见。
zIndex optional
类型：  number optional
相对于其他折线的 zIndex。

StrokePosition 常量

google.maps.StrokePosition 常量

多边形上描边的可能位置。

通过调用 const {StrokePosition} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。
CENTER 笔触位于多边形路径的中心，一半在多边形内部，一半在多边形外部。
INSIDE 描边位于多边形内。
OUTSIDE 笔划位于多边形外部。