Polygons

Polygon 类

google.maps.Polyline 类

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

此类扩展了 MVCObject。

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

构造函数
Polyline	Polyline([opts]) 参数： opts：PolylineOptions optional 使用传递的 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 返回值：None 如果设置为 true，用户可在地图上拖动此形状。geodesic 属性定义拖动模式。
setEditable	setEditable(editable) 参数： editable：boolean 返回值：None 如果设为 true，用户可通过拖动顶点处和每个线段上的控制点来修改此形状。
setMap	setMap(map) 参数： map：Map optional 返回值：None 在指定地图上渲染此形状。如果地图设置为null，系统将会移除该形状。
setOptions	setOptions(options) 参数： options：PolylineOptions optional 返回值：None
setPath	setPath(path) 参数： path：MVCArray<LatLng>|Array<LatLng|LatLngLiteral> 返回值：None 设置路径。如需了解详情，请参阅 PolylineOptions。
setVisible	setVisible(visible) 参数： visible：boolean 返回值：None 如果设置为 false，则会隐藏此多边形。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活动
click	function(event) 参数： event：PolyMouseEvent 对折线触发 DOM click 事件时会触发此事件。
contextmenu	function(event) 参数： event：PolyMouseEvent 在 Poyline 上触发 DOM contextmenu 事件时会触发此事件。
dblclick	function(event) 参数： event：PolyMouseEvent 对折线触发 DOM dblclick 事件时会触发此事件。
drag	function(event) 参数： event：MapMouseEvent 当用户拖动多段线时会反复触发此事件。
dragend	function(event) 参数： event：MapMouseEvent 当用户停止拖动多段线时会触发此事件。
dragstart	function(event) 参数： event：MapMouseEvent 当用户开始拖动多段线时会触发此事件。
mousedown	function(event) 参数： event：PolyMouseEvent 对折线触发 DOM mousedown 事件时会触发此事件。
mousemove	function(event) 参数： event：PolyMouseEvent 对折线触发 DOM mousemove 事件时会触发此事件。
mouseout	function(event) 参数： event：PolyMouseEvent 此事件针对折线 mouseout 触发。
mouseover	function(event) 参数： event：PolyMouseEvent 此事件针对折线 mouseover 触发。
mouseup	function(event) 参数： event：PolyMouseEvent 对折线触发 DOM mouseup 事件时会触发此事件。
rightclick	已废弃：请改用 Polyline.contextmenu 事件，以便支持 macOS 上的 Control-Click 等使用模式。 function(event) 参数： event：PolyMouseEvent 右键点击折线时会触发此事件。

PolylineOptions 接口

google.maps.PolylineOptions 接口

PolygonOptions 对象用于定义可针对多段线设置的属性。

属性
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 中插入或移除 LatLngs 会自动更新地图上的多段线。
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]) 参数： opts：PolygonOptions optional 使用传递的 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 返回值：None 如果设置为 true，用户可在地图上拖动此形状。geodesic 属性定义拖动模式。
setEditable	setEditable(editable) 参数： editable：boolean 返回值：None 如果设为 true，用户可通过拖动顶点处和每个线段上的控制点来修改此形状。
setMap	setMap(map) 参数： map：Map optional 返回值：None 在指定地图上渲染此形状。如果地图设置为null，系统将会移除该形状。
setOptions	setOptions(options) 参数： options：PolygonOptions optional 返回值：None
setPath	setPath(path) 参数： path：MVCArray<LatLng>|Array<LatLng|LatLngLiteral> 返回值：None 设置第一条路径。如需了解详情，请参阅 PolygonOptions。
setPaths	setPaths(paths) 参数： paths：MVCArray<MVCArray<LatLng>>|MVCArray<LatLng>|Array<Array<LatLng|LatLngLiteral>>|Array<LatLng|LatLngLiteral> 返回值：None 设置此多边形的路径。
setVisible	setVisible(visible) 参数： visible：boolean 返回值：None 如果设置为 false，则会隐藏此多边形。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活动
click	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM click 事件时会触发此事件。
contextmenu	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM contextmenu 事件时会触发此事件。
dblclick	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM dblclick 事件时会触发此事件。
drag	function(event) 参数： event：MapMouseEvent 当用户拖动多边形时会反复触发此事件。
dragend	function(event) 参数： event：MapMouseEvent 当用户停止拖动多边形时会触发此事件。
dragstart	function(event) 参数： event：MapMouseEvent 当用户开始拖动多边形时会触发此事件。
mousedown	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM mousedown 事件时会触发此事件。
mousemove	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM mousemove 事件时会触发此事件。
mouseout	function(event) 参数： event：PolyMouseEvent 此事件针对多边形 mouseout 触发。
mouseover	function(event) 参数： event：PolyMouseEvent 此事件针对多边形 mouseover 触发。
mouseup	function(event) 参数： event：PolyMouseEvent 对多边形触发 DOM mouseup 事件时会触发此事件。
rightclick	已废弃：请改用 Polygon.contextmenu 事件，以便支持 macOS 上的 Control-Click 等使用模式。 function(event) 参数： event：PolyMouseEvent 右键点击多边形时会触发此事件。

PolygonOptions 接口

google.maps.PolygonOptions 接口

PolygonOptions 对象用于定义可在 Polygon 上设置的属性。

属性
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	类型：MVCArray<MVCArray<LatLng>>|MVCArray<LatLng>|Array<Array<LatLng|LatLngLiteral>>|Array<LatLng|LatLngLiteral> optional 用于指定闭合环的坐标的有序序列。不同于折线，一个多边形由一条或多条路径组成。因此，路径属性可以指定一个或多个 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]) 参数： opts：RectangleOptions optional 使用传递的 RectangleOptions（用于指定边界和样式）创建一个矩形。

方法
getBounds	getBounds() 参数：无 返回值：LatLngBounds|null 传回此矩形的范围。
getDraggable	getDraggable() 参数：无 返回值：boolean 返回用户是否可以拖动此矩形。
getEditable	getEditable() 参数：无 返回值：boolean 返回用户是否可以修改此矩形。
getMap	getMap() 参数：无 返回值：Map|null 传回显示此矩形的地图。
getVisible	getVisible() 参数：无 返回值：boolean 返回此矩形是否在地图上可见。
setBounds	setBounds(bounds) 参数： bounds：LatLngBounds|LatLngBoundsLiteral optional 返回值：None 设置此矩形的范围。
setDraggable	setDraggable(draggable) 参数： draggable：boolean 返回值：None 如果设置为 true，用户可在地图上拖动此矩形。
setEditable	setEditable(editable) 参数： editable：boolean 返回值：None 如果设为 true，用户可通过拖动角落和每条边上的控制点来修改此矩形。
setMap	setMap(map) 参数： map：Map optional 返回值：None 在指定地图上渲染此矩形。如果地图设置为 null，则会移除该矩形。
setOptions	setOptions(options) 参数： options：RectangleOptions optional 返回值：None
setVisible	setVisible(visible) 参数： visible：boolean 返回值：None 如果设置为 false，则会隐藏此矩形。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活动
bounds_changed	function() 参数：None 在更改矩形的边界时会触发此事件。
click	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM click 事件时会触发此事件。
contextmenu	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM contextmenu 事件时会触发此事件。
dblclick	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM dblclick 事件时会触发此事件。
drag	function(event) 参数： event：MapMouseEvent 当用户拖动矩形时会反复触发此事件。
dragend	function(event) 参数： event：MapMouseEvent 当用户停止拖动矩形时会触发此事件。
dragstart	function(event) 参数： event：MapMouseEvent 当用户开始拖动矩形时会触发此事件。
mousedown	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM mousedown 事件时会触发此事件。
mousemove	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM mousemove 事件时会触发此事件。
mouseout	function(event) 参数： event：MapMouseEvent 此事件针对矩形 mouseout 触发。
mouseover	function(event) 参数： event：MapMouseEvent 此事件针对矩形鼠标悬停触发。
mouseup	function(event) 参数： event：MapMouseEvent 对矩形触发 DOM mouseup 事件时会触发此事件。
rightclick	已废弃：请改用 Rectangle.contextmenu 事件，以便支持 macOS 上的 Control-Click 等使用模式。 function(event) 参数： event：MapMouseEvent 右键点击矩形时会触发此事件。

RectangleOptions 接口

google.maps.RectangleOptions 接口

RectangleOptions 对象用于定义可在 Rectangle 上设置的属性。

属性
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]) 参数： circleOrCircleOptions：Circle|CircleLiteral|CircleOptions optional 使用传递的 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) 参数： center：LatLng|LatLngLiteral optional 返回值：None 设置此圆的中心。
setDraggable	setDraggable(draggable) 参数： draggable：boolean 返回值：None 如果设置为 true，用户可以在地图上拖动此圆圈。
setEditable	setEditable(editable) 参数： editable：boolean 返回值：None 如果设为 true，用户可通过拖动圆圈中心和周围显示的控制点来编辑此圆圈。
setMap	setMap(map) 参数： map：Map optional 返回值：None 在指定地图上渲染此圆。如果地图设置为null，则会移除圆形。
setOptions	setOptions(options) 参数： options：CircleOptions optional 返回值：None
setRadius	setRadius(radius) 参数： radius：number 返回值：None 设置此圆的半径（以米为单位）。
setVisible	setVisible(visible) 参数： visible：boolean 返回值：None 如果设为“false”，则会隐藏此圆形。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活动
center_changed	function() 参数：None 当圆的中心改变时会触发此事件。
click	function(event) 参数： event：MapMouseEvent 对圆触发 DOM 点击事件时会触发此事件。
dblclick	function(event) 参数： event：MapMouseEvent 对圆触发 DOM dblclick 事件时会触发此事件。
drag	function(event) 参数： event：MapMouseEvent 当用户拖动圆圈时会反复触发此事件。
dragend	function(event) 参数： event：MapMouseEvent 当用户停止拖动圆形时会触发此事件。
dragstart	function(event) 参数： event：MapMouseEvent 当用户开始拖动圆形时会触发此事件。
mousedown	function(event) 参数： event：MapMouseEvent 对圆触发 DOM mousedown 事件时会触发此事件。
mousemove	function(event) 参数： event：MapMouseEvent 对圆触发 DOM mousemove 事件时会触发此事件。
mouseout	function(event) 参数： event：MapMouseEvent 此事件针对圆形 mouseout 触发。
mouseover	function(event) 参数： event：MapMouseEvent 此事件针对圆鼠标悬停触发。
mouseup	function(event) 参数： event：MapMouseEvent 对圆触发 DOM mouseup 事件时会触发此事件。
radius_changed	function() 参数：None 当圆的半径改变时会触发此事件。
rightclick	function(event) 参数： event：MapMouseEvent 右键点击圆圈时会触发此事件。

CircleOptions 接口

google.maps.CircleOptions 接口

CircleOptions 对象用于定义可在 Circle 上设置的属性。

属性
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	描边位于多边形外。