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
返回 DrawingManager 附加到的 Map,即创建的叠加层将放置在其上的 Map
setDrawingMode
setDrawingMode(drawingMode)
参数: 
返回值:None
更改 DrawingManager 的绘制模式,该模式用于定义要添加到地图上的叠加层的类型。接受的值包括 'marker''polygon''polyline''rectangle''circle'null。绘制模式为 null 表示用户可以照常与地图互动,并且点击不会绘制任何内容。
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'null。绘制模式为 null 表示用户可以照常与地图互动,并且点击不会绘制任何内容。
map optional
类型:  Map optional
DrawingManager 附加到的 Map,即将放置创建的叠加层的 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 事件中给出的叠加层是矩形。