Drawing Library

DrawingManager

google.maps.drawing.DrawingManager

允许用户在地图上绘制标记、多边形、多段线、矩形和圆形。DrawingManager 的绘制模式定义了用户将创建的叠加层的类型。用于向地图添加控件,允许用户切换绘图模式。

此类扩展了 MVCObject

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

DrawingManager
DrawingManager([options])
参数
创建一个 DrawingManager,让用户可以在地图上绘制叠加层,并使用绘图控件在要绘制的叠加层类型之间切换。
getDrawingMode
getDrawingMode()
参数:无
返回值OverlayType|null
返回 DrawingManager 的绘制模式。
getMap
getMap()
参数:无
返回值Map
返回附加 DrawingManagerMap,即创建的叠加层将放置在 Map 上。
setDrawingMode
setDrawingMode(drawingMode)
参数
返回值:None
用于更改 DrawingManager 的绘制模式,该模式用于定义要在地图上添加的叠加层的类型。接受的值包括 'marker''polygon''polyline''rectangle''circle'nullnull 绘制模式表示用户可以正常与地图互动,点击不会绘制任何内容。
setMap
setMap(map)
参数
返回值:None
DrawingManager 对象附加到指定的 Map
setOptions
setOptions(options)
参数
返回值:None
设置 DrawingManager 的选项。
继承的样式addListenerbindTogetnotifysetsetValuesunbindunbindAll
circlecomplete
function(circle)
参数
  • circleCircle 用户刚刚绘制的圆形。
当用户完成圆的绘制时会触发此事件。
markercomplete
function(marker)
参数
  • markerMarker 用户刚刚绘制的标记。
当用户完成标记的绘制时会触发此事件。
overlaycomplete
function(event)
参数
当用户完成任何类型的叠加层的绘制时会触发此事件。
polygoncomplete
function(polygon)
参数
  • polygonPolygon用户刚刚绘制的多边形。
当用户完成多边形的绘制时会触发此事件。
polylinecomplete
function(polyline)
参数
  • polylinePolyline用户刚刚绘制的多段线。
当用户完成多段线的绘制时会触发此事件。
rectanglecomplete
function(rectangle)
参数
  • rectangleRectangle 用户刚刚绘制的矩形。
当用户完成矩形的绘制时会触发此事件。

DrawingManagerOptions 接口

google.maps.drawing.DrawingManagerOptions 接口

绘图管理器的选项。

circleOptions optional
类型CircleOptions optional
应用于使用此DrawingManager创建的任何新圈子的选项。系统会忽略 centerradius 属性,并始终将新圆形的 map 属性设为 DrawingManager 的地图。
drawingControl optional
类型boolean optional
默认值true
绘图控件的启用/停用状态。
drawingControlOptions optional
类型DrawingControlOptions optional
绘图控件的显示选项。
drawingMode optional
类型OverlayType optional
DrawingManager 的绘制模式,用于定义要在地图上添加的叠加层的类型。接受的值包括 'marker''polygon''polyline''rectangle''circle'nullnull 绘制模式表示用户可以正常与地图互动,点击不会绘制任何内容。
map optional
类型Map optional
附加 DrawingManagerMap,即创建的叠加层将放置在 Map 上。
markerOptions optional
类型MarkerOptions optional
用于应用到使用此 DrawingManager 创建的任何新标记的选项。系统会忽略 position 属性,并始终将新标记的 map 属性设为 DrawingManager 的地图。
polygonOptions optional
类型PolygonOptions optional
应用于使用此 DrawingManager 创建的任何新多边形的选项。系统会忽略 paths 属性,并始终将新多边形的 map 属性设为 DrawingManager 的地图。
polylineOptions optional
类型PolylineOptions optional
应用于使用此 DrawingManager 创建的任何新多段线的选项。系统会忽略 path 属性,并始终将新多段线的 map 属性设为 DrawingManager 的地图。
rectangleOptions optional
类型RectangleOptions optional
用于应用于使用此 DrawingManager 创建的任何新矩形的选项。系统会忽略 bounds 属性,并始终将新矩形的 map 属性设为 DrawingManager 的映射。

DrawingControlOptions 接口

google.maps.drawing.DrawingControlOptions 接口

用于渲染绘图控件的选项。

drawingModes optional
类型Array<OverlayType> optional
绘制控件中显示的绘制模式,以其显示顺序为先。手形图标(对应于 null 绘制模式)始终可用,并且无需在此数组中指定。
position optional
类型ControlPosition optional
位置 ID。用于指定控件在地图上的位置。

OverlayCompleteEvent 接口

google.maps.drawing.OverlayCompleteEvent 接口

DrawingManager 上的 overlaycomplete 事件的属性。

overlay
完成后的叠加层。
type
类型OverlayType
已完成的叠加层的类型。

OverlayType 常量

google.maps.drawing.OverlayType 常量

可通过 DrawingManager 创建的叠加层的类型。通过值或使用常量名称来指定这些变量。例如 'polygon'google.maps.drawing.OverlayType.POLYGON

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

CIRCLE 指定 DrawingManager 创建圆形,并且在 overlaycomplete 事件中给定的叠加层为圆形。
MARKER 指定 DrawingManager 创建标记,并在 overlaycomplete 事件中给出的叠加层是标记。
POLYGON 指定 DrawingManager 创建多边形,并且在 overlaycomplete 事件中指定的叠加层是多边形。
POLYLINE 指定 DrawingManager 创建多段线,并且在 overlaycomplete 事件中指定的叠加层是多段线。
RECTANGLE 指定 DrawingManager 创建矩形,并在 overlaycomplete 事件中给定的叠加层是矩形。