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)
参数
返回值:无
用于更改 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 事件中提供的叠加层是矩形。