Polygon 类
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()参数：无
检索路径。 |
getVisible |
getVisible()参数：无
返回值：
boolean返回此多边形是否在地图上显示。 |
setDraggable |
setDraggable(draggable)参数：
返回值：None
如果设置为 true，用户可在地图上拖动此形状。geodesic 属性定义拖动模式。 |
setEditable |
setEditable(editable)参数：
返回值：None
如果设为 true，用户可通过拖动顶点处和每个线段上的控制点来修改此形状。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此形状。如果地图设置为 null，系统将会移除该形状。 |
setOptions |
setOptions(options)参数：
返回值：None
|
setPath |
setPath(path)参数：
返回值：None
设置路径。如需了解详情，请参阅 PolylineOptions。 |
setVisible |
setVisible(visible)参数：
返回值：None
如果设置为 false，则会隐藏此多边形。 |
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
活动 | |
|---|---|
click |
function(event)参数：
对折线触发 DOM click 事件时会触发此事件。 |
contextmenu |
function(event)参数：
在 Poyline 上触发 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 事件时会触发此事件。 |
|
function(event)参数：
右键点击折线时会触发此事件。 |
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])参数：
使用传递的 PolygonOptions 创建一个多边形，用于指定多边形的路径、多边形边缘的描边样式，以及多边形内部区域的填充样式。一个多边形可以包含一条或多条路径，其中每条路径都由一系列 LatLng 组成。在构建这些路径时，您可以传递 LatLng 数组或 LatLng 的 MVCArray。实例化时，数组会在多边形中转换为 MVCArray。 |
方法 | |
|---|---|
getDraggable |
getDraggable()参数：无
返回值：
boolean返回用户是否可以拖动此形状。 |
getEditable |
getEditable()参数：无
返回值：
boolean返回用户是否可以修改此形状。 |
getMap |
getMap()参数：无
返回值：
Map|null用于返回附加了此形状的地图。 |
getPath |
getPath()参数：无
检索第一条路径。 |
getPaths |
getPaths()参数：无
检索此多边形的路径。 |
getVisible |
getVisible()参数：无
返回值：
boolean返回此多边形是否在地图上显示。 |
setDraggable |
setDraggable(draggable)参数：
返回值：None
如果设置为 true，用户可在地图上拖动此形状。geodesic 属性定义拖动模式。 |
setEditable |
setEditable(editable)参数：
返回值：None
如果设为 true，用户可通过拖动顶点处和每个线段上的控制点来修改此形状。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此形状。如果地图设置为 null，系统将会移除该形状。 |
setOptions |
setOptions(options)参数：
返回值：None
|
setPath |
setPath(path)参数：
返回值：None
设置第一条路径。如需了解详情，请参阅 PolygonOptions。 |
setPaths |
setPaths(paths)参数：
返回值：None
设置此多边形的路径。 |
setVisible |
setVisible(visible)参数：
返回值：None
如果设置为 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 事件时会触发此事件。 |
|
function(event)参数：
右键点击多边形时会触发此事件。 |
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描边位置。 |
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)参数：
返回值：None
设置此矩形的范围。 |
setDraggable |
setDraggable(draggable)参数：
返回值：None
如果设置为 true，用户可在地图上拖动此矩形。 |
setEditable |
setEditable(editable)参数：
返回值：None
如果设为 true，用户可通过拖动角落和每条边上的控制点来修改此矩形。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此矩形。如果地图设置为 null，则会移除该矩形。 |
setOptions |
setOptions(options)参数：
返回值：None
|
setVisible |
setVisible(visible)参数：
返回值：None
如果设置为 false，则会隐藏此矩形。 |
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
活动 | |
|---|---|
bounds_changed |
function()参数：None
在更改矩形的边界时会触发此事件。 |
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)参数：
此事件针对矩形鼠标悬停触发。 |
mouseup |
function(event)参数：
对矩形触发 DOM mouseup 事件时会触发此事件。 |
|
function(event)参数：
右键点击矩形时会触发此事件。 |
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描边位置。 |
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)参数：
返回值：None
设置此圆的中心。 |
setDraggable |
setDraggable(draggable)参数：
返回值：None
如果设置为 true，用户可以在地图上拖动此圆圈。 |
setEditable |
setEditable(editable)参数：
返回值：None
如果设为 true，用户可通过拖动圆圈中心和周围显示的控制点来编辑此圆圈。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此圆。如果地图设置为 null，则会移除圆形。 |
setOptions |
setOptions(options)参数：
返回值：None
|
setRadius |
setRadius(radius)参数：
返回值：None
设置此圆的半径（以米为单位）。 |
setVisible |
setVisible(visible)参数：
返回值：None
如果设为“ 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)参数：
此事件针对圆形 mouseout 触发。 |
mouseover |
function(event)参数：
此事件针对圆鼠标悬停触发。 |
mouseup |
function(event)参数：
对圆触发 DOM mouseup 事件时会触发此事件。 |
radius_changed |
function()参数：None
当圆的半径改变时会触发此事件。 |
rightclick |
function(event)参数：
右键点击圆圈时会触发此事件。 |
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描边位置。 |
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 |
描边位于多边形外。 |