Polygons

Polyline 类

class google.maps.Polyline extends MVCObject
library "maps"

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

const {Polyline} = await google.maps.importLibrary("maps");

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

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

PolylineOptions 接口

接口 google.maps.PolylineOptions

PolylineOptions 对象，用于定义可在 Polyline 上设置的属性。

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

IconSequence 接口

接口 google.maps.IconSequence

描述如何在一条线上呈现图标。

如果您的多段线为测地线，则默认以米为单位计算为偏移量和重复间隔指定的距离。如果将 offset 或 repeat 设置为像素值，则系统会以屏幕上的像素为单位计算距离。

属性
fixedRotation 可选	类型：boolean optional 默认值：false 如果为 true，则序列中的每个图标都具有相同的固定旋转角度，无论其所在边缘的角度如何。如果为 false，则序列中的每个图标都会旋转，以便与其边缘对齐。
icon 可选	类型：Symbol optional 要在折线上呈现的图标。
offset 可选	类型：string optional 默认值：'100%' 距线条起点（图标渲染位置）的距离。该距离可以线条长度百分比（例如“50%”）或像素（例如“50 像素”）表示。
repeat 可选	类型：string optional 默认值：0 线条上连续图标之间的间距。该距离可以线条长度百分比（例如“50%”）或像素（例如“50 像素”）表示。若要停用图标重复，请指定“0”。

Polygon 类

class google.maps.Polygon extends MVCObject
library "maps"

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

const {Polygon} = await google.maps.importLibrary("maps");

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

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

PolygonOptions 接口

接口 google.maps.PolygonOptions

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

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

PolyMouseEvent 接口

interface google.maps.PolyMouseEvent extends MapMouseEvent

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

属性
edge 可选	类型：number optional 事件发生时，光标下方路径中边的索引（如果事件发生在可修改多边形的中点上）。
path 可选	类型：number optional 如果事件发生在顶点上且多边形可修改，则为事件发生时位于光标下方的路径的索引。否则为 undefined。
vertex 可选	类型：number optional 如果事件发生在顶点上，并且多段线或多边形可修改，则为事件发生时位于光标下方的顶点的索引。如果事件未发生在顶点上，则值为 undefined。
继承的方法： domEvent、latLng

方法
继承： stop

Rectangle 类

class google.maps.Rectangle extends MVCObject
library "maps"

矩形叠加层。

const {Rectangle} = await google.maps.importLibrary("maps");

构造函数
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 返回值：无 设置此矩形的范围。
setDraggable	setDraggable(draggable) 参数： draggable: boolean 返回值：无 如果设置为 true，用户可以在地图上拖动此矩形。
setEditable	setEditable(editable) 参数： editable: boolean 返回值：无 如果设置为 true，用户可以通过拖动角上和每条边上显示的控制点来修改此矩形。
setMap	setMap(map) 参数： map: Map optional 返回值：无 在指定地图上渲染此矩形。如果将 map 设置为 null，则系统会移除该矩形。
setOptions	setOptions(options) 参数： options: RectangleOptions optional 返回值：无
setVisible	setVisible(visible) 参数： visible: boolean 返回值：无 如果设置为 false，则隐藏此矩形。
继承的方法： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

事件
bounds_changed	function() 参数：无 此事件会在矩形的边界发生更改时触发。
click	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM 点击事件时，会触发此事件。
contextmenu	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM contextmenu 事件时，会触发此事件。
dblclick	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM dblclick 事件时，会触发此事件。
drag	function(event) 参数： event: MapMouseEvent optional 在用户拖动矩形期间，此事件会反复触发。
dragend	function(event) 参数： event: MapMouseEvent optional 此事件会在用户停止拖动矩形时触发。
dragstart	function(event) 参数： event: MapMouseEvent optional 当用户开始拖动矩形时，会触发此事件。
mousedown	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM mousedown 事件时，会触发此事件。
mousemove	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM mousemove 事件时，会触发此事件。
mouseout	function(event) 参数： event: MapMouseEvent optional 当鼠标移出矩形时，会触发此事件。
mouseover	function(event) 参数： event: MapMouseEvent optional 此事件在鼠标悬停在矩形上时触发。
mouseup	function(event) 参数： event: MapMouseEvent optional 当在矩形上触发 DOM mouseup 事件时，会触发此事件。
rightclick	已弃用：请改用 Rectangle.contextmenu 事件，以支持 macOS 上的 Control 键 + 点击等使用模式。 function(event) 参数： event: MapMouseEvent optional 当用户右键点击矩形时，系统会触发此事件。

RectangleOptions 接口

接口 google.maps.RectangleOptions

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

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

Circle 类

class google.maps.Circle extends MVCObject
library "maps"

地球表面上的圆圈，也称为“球冠”。

const {Circle} = await google.maps.importLibrary("maps");

构造函数
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 返回值：无 设置此圆的中心。
setDraggable	setDraggable(draggable) 参数： draggable: boolean 返回值：无 如果设置为 true，用户可以在地图上拖动此圆形。
setEditable	setEditable(editable) 参数： editable: boolean 返回值：无 如果设置为 true，用户可以通过拖动圆心和圆周周围显示的控制点来修改此圆。
setMap	setMap(map) 参数： map: Map optional 返回值：无 在指定地图上渲染此圆。如果将 map 设置为 null，则系统会移除该圆形。
setOptions	setOptions(options) 参数： options: CircleOptions optional 返回值：无
setRadius	setRadius(radius) 参数： radius: number 返回值：无 设置此圆的半径（以米为单位）。
setVisible	setVisible(visible) 参数： visible: boolean 返回值：无 如果设置为 false，则隐藏此圆圈。
继承的方法： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

事件
center_changed	function() 参数：无 此事件会在圆心发生更改时触发。
click	function(event) 参数： event: MapMouseEvent optional 当在圆形上触发 DOM 点击事件时，系统会触发此事件。
dblclick	function(event) 参数： event: MapMouseEvent optional 当在圆上触发 DOM dblclick 事件时，会触发此事件。
drag	function(event) 参数： event: MapMouseEvent optional 在用户拖动圆形期间，此事件会反复触发。
dragend	function(event) 参数： event: MapMouseEvent optional 当用户停止拖动圆圈时，系统会触发此事件。
dragstart	function(event) 参数： event: MapMouseEvent optional 当用户开始拖动圆形时，会触发此事件。
mousedown	function(event) 参数： event: MapMouseEvent optional 当在圆圈上触发 DOM mousedown 事件时，会触发此事件。
mousemove	function(event) 参数： event: MapMouseEvent optional 当在圆圈上触发 DOM mousemove 事件时，会触发此事件。
mouseout	function(event) 参数： event: MapMouseEvent optional 此事件在鼠标移出圆圈时触发。
mouseover	function(event) 参数： event: MapMouseEvent optional 当鼠标悬停在圆圈上时，会触发此事件。
mouseup	function(event) 参数： event: MapMouseEvent optional 当在圆圈上触发 DOM mouseup 事件时，会触发此事件。
radius_changed	function() 参数：无 此事件会在圆形的半径发生变化时触发。
rightclick	function(event) 参数： event: MapMouseEvent optional 当用户右键点击圆圈时，系统会触发此事件。

CircleOptions 接口

接口 google.maps.CircleOptions
由 CircleLiteral 扩展

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

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

StrokePosition 常量

常量 google.maps.StrokePosition
库 "maps"

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

const {StrokePosition} = await google.maps.importLibrary("maps");

常量
CENTER	边框以多边形的路径为中心，一半边框位于多边形内部，另一半边框位于多边形外部。
INSIDE	描边位于多边形内部。
OUTSIDE	描边位于多边形外部。