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)
参数: 
返回值:无
更改 DrawingManager 的绘制模式,该模式用于定义要添加到地图上的叠加层类型。接受的值包括 'marker''polygon''polyline''rectangle''circle'null。绘制模式为 null 表示用户可以像往常一样与地图互动,点击不会绘制任何内容。
setMap
setMap(map)
参数: 
返回值:无
DrawingManager 对象附加到指定的 Map
setOptions
setOptions(options)
参数: 
返回值:无
设置 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 事件中给定的叠加层是矩形。