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