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() 参数:无
检索路径。 |
getVisible |
getVisible() 参数:无
返回值:
boolean 返回此多边形在地图上是否可见。 |
setDraggable |
setDraggable(draggable) 参数:
返回值:None
如果设置为 true ,用户可以将此形状拖动到地图上。geodesic 属性用于定义拖动模式。 |
setEditable |
setEditable(editable) 参数:
返回值:None
如果设置为 true ,用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。 |
setMap |
setMap(map) 参数:
返回值:None
在地图上渲染此形状。如果将 map 设置为 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
接口
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() 参数:无
检索第一条路径。 |
getPaths |
getPaths() 参数:无
检索此多边形的路径。 |
getVisible |
getVisible() 参数:无
返回值:
boolean 返回此多边形在地图上是否可见。 |
setDraggable |
setDraggable(draggable) 参数:
返回值:None
如果设置为 true ,用户可以将此形状拖动到地图上。geodesic 属性用于定义拖动模式。 |
setEditable |
setEditable(editable) 参数:
返回值:None
如果设置为 true ,用户可以通过拖动顶点和每个线段上显示的控制点来修改此形状。 |
setMap |
setMap(map) 参数:
返回值:None
在地图上渲染此形状。如果将 map 设置为 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 对象,用于定义可在多边形上设置的属性。
属性 | |
---|---|
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 用于指定闭合环的坐标的有序序列。不同于折线,一个多边形由一条或多条路径组成。因此,paths 属性可以指定一个或多个 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 创建矩形,该 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 点击事件时,系统会触发此事件。 |
contextmenu |
function(event) 参数:
当矩形上触发 DOM contextmenu 事件时,系统会触发此事件。 |
dblclick |
function(event) 参数:
当对矩形触发 DOM 双击事件时,系统会触发此事件。 |
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 鼠标释放事件时,系统会触发此事件。 |
|
function(event) 参数:
当用户右键点击矩形时,系统会触发此事件。 |
RectangleOptions 接口
google.maps.RectangleOptions
接口
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 笔触位置。 |
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
在指定地图上渲染此圆。如果将 map 设置为 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 双击事件时,系统会触发此事件。 |
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 鼠标释放事件时,系统会触发此事件。 |
radius_changed |
function() 参数:None
当圆形的半径发生变化时,系统会触发此事件。 |
rightclick |
function(event) 参数:
当用户右键点击圆圈时,系统会触发此事件。 |
CircleOptions 接口
google.maps.CircleOptions
接口
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 笔触位置。 |
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 |
笔触位于多边形外部。 |