Security notice:We have become aware of a security issue that may be affecting websites using specific third-party libraries (including polyfill.io). This issue can sometimes redirect visitors away from the intended website without website owner knowledge or permission. Many of our JavaScript samples previously included apolyfill.ioscript declaration. We have removed this from our samples. If you have used our JavaScript samples that contain this declaration, we recommend removing the declaration.

Drawing Library

DrawingManager class

google.maps.drawing.DrawingManager class

Allows users to draw markers, polygons, polylines, rectangles, and circles on the map. TheDrawingManager's drawing mode defines the type of overlay that will be created by the user. Adds a control to the map, allowing the user to switch drawing mode.

This class extends MVCObject.

Access by callingconst {DrawingManager} = await google.maps.importLibrary( "drawing" ).SeeLibraries in the Maps JavaScript API.

Constructor
`DrawingManager`	`DrawingManager([options])` Parameters: `options`:`DrawingManagerOptionsoptional` Creates a`DrawingManager`that allows users to draw overlays on the map, and switch between the type of overlay to be drawn with a drawing control.

Methods
`getDrawingMode`	`getDrawingMode()` Parameters:None Return Value:`OverlayType\|null` Returns the`DrawingManager`'s drawing mode.
`getMap`	`getMap()` Parameters:None Return Value:`Map` Returns the`Map`to which the`DrawingManager`is attached, which is the`Map`on which the overlays created will be placed.
`setDrawingMode`	`setDrawingMode(drawingMode)` Parameters: `drawingMode`:`OverlayTypeoptional` Return Value:None Changes the`DrawingManager`'s drawing mode, which defines the type of overlay to be added on the map. Accepted values are`'marker'`,`'polygon'`,`'polyline'`,`'rectangle'`,`'circle'`,or`null`.A drawing mode of`null`means that the user can interact with the map as normal, and clicks do not draw anything.
`setMap`	`setMap(map)` Parameters: `map`:`Map` Return Value:None Attaches the`DrawingManager`object to the specified`Map`.
`setOptions`	`setOptions(options)` Parameters: `options`:`DrawingManagerOptions` Return Value:None Sets the`DrawingManager`'s options.
Inherited: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Events
`circlecomplete`	`function(circle)` Arguments: `circle`:`Circle`The circle that the user has just drawn. This event is fired when the user has finished drawing a circle.
`markercomplete`	`function(marker)` Arguments: `marker`:`Marker`The marker that the user has just drawn. This event is fired when the user has finished drawing a marker.
`overlaycomplete`	`function(event)` Arguments: `event`:`OverlayCompleteEvent`The overlay that the user has just drawn, together with the type of the overlay. This event is fired when the user has finished drawing an overlay of any type.
`polygoncomplete`	`function(polygon)` Arguments: `polygon`:`Polygon`The polygon that the user has just drawn. This event is fired when the user has finished drawing a polygon.
`polylinecomplete`	`function(polyline)` Arguments: `polyline`:`Polyline`The polyline that the user has just drawn. This event is fired when the user has finished drawing a polyline.
`rectanglecomplete`	`function(rectangle)` Arguments: `rectangle`:`Rectangle`The rectangle that the user has just drawn. This event is fired when the user has finished drawing a rectangle.

DrawingManagerOptions interface

google.maps.drawing.DrawingManagerOptions interface

Options for the drawing manager.

Properties
`circleOptionsoptional`	Type:`CircleOptionsoptional` Options to apply to any new circles created with this`DrawingManager`.The`center`and`radius`properties are ignored, and the`map`property of a new circle is always set to the`DrawingManager`'s map.
`drawingControloptional`	Type:`booleanoptional` Default:`true` The enabled/disabled state of the drawing control.
`drawingControlOptionsoptional`	Type:`DrawingControlOptionsoptional` The display options for the drawing control.
`drawingModeoptional`	Type:`OverlayTypeoptional` The`DrawingManager`'s drawing mode, which defines the type of overlay to be added on the map. Accepted values are`'marker'`,`'polygon'`,`'polyline'`,`'rectangle'`,`'circle'`,or`null`.A drawing mode of`null`means that the user can interact with the map as normal, and clicks do not draw anything.
`mapoptional`	Type:`Mapoptional` The`Map`to which the`DrawingManager`is attached, which is the`Map`on which the overlays created will be placed.
`markerOptionsoptional`	Type:`MarkerOptionsoptional` Options to apply to any new markers created with this`DrawingManager`.The`position`property is ignored, and the`map`property of a new marker is always set to the`DrawingManager`'s map.
`polygonOptionsoptional`	Type:`PolygonOptionsoptional` Options to apply to any new polygons created with this`DrawingManager`.The`paths`property is ignored, and the`map`property of a new polygon is always set to the`DrawingManager`'s map.
`polylineOptionsoptional`	Type:`PolylineOptionsoptional` Options to apply to any new polylines created with this`DrawingManager`.The`path`property is ignored, and the`map`property of a new polyline is always set to the`DrawingManager`'s map.
`rectangleOptionsoptional`	Type:`RectangleOptionsoptional` Options to apply to any new rectangles created with this`DrawingManager`.The`bounds`property is ignored, and the`map`property of a new rectangle is always set to the`DrawingManager`'s map.

DrawingControlOptions interface

google.maps.drawing.DrawingControlOptions interface

Options for the rendering of the drawing control.

Properties
`drawingModesoptional`	Type:`Array<OverlayType>optional` Default:`[OverlayType.MARKER,OverlayType.POLYLINE,OverlayType.RECTANGLE,OverlayType.CIRCLE,OverlayType.POLYGON]` The drawing modes to display in the drawing control, in the order in which they are to be displayed. The hand icon (which corresponds to the`null`drawing mode) is always available and is not to be specified in this array.
`positionoptional`	Type:`ControlPositionoptional` Default:`ControlPosition.TOP_LEFT` Position id. Used to specify the position of the control on the map.

OverlayCompleteEvent interface

google.maps.drawing.OverlayCompleteEvent interface

The properties of an overlaycomplete event on aDrawingManager.

Properties
`overlay`	Type:`Marker\|Polygon\|Polyline\|Rectangle\|Circle` The completed overlay.
`type`	Type:`OverlayType` The completed overlay's type.

OverlayType constants

google.maps.drawing.OverlayType constants

The types of overlay that may be created by theDrawingManager.Specify these by value, or by using the constant's name. For example,'polygon'orgoogle.maps.drawing.OverlayType.POLYGON.

Access by callingconst {OverlayType} = await google.maps.importLibrary( "drawing" ).SeeLibraries in the Maps JavaScript API.

Constants
`CIRCLE`	Specifies that the`DrawingManager`creates circles, and that the overlay given in the`overlaycomplete`event is a circle.
`MARKER`	Specifies that the`DrawingManager`creates markers, and that the overlay given in the`overlaycomplete`event is a marker.
`POLYGON`	Specifies that the`DrawingManager`creates polygons, and that the overlay given in the`overlaycomplete`event is a polygon.
`POLYLINE`	Specifies that the`DrawingManager`creates polylines, and that the overlay given in the`overlaycomplete`event is a polyline.
`RECTANGLE`	Specifies that the`DrawingManager`creates rectangles, and that the overlay given in the`overlaycomplete`event is a rectangle.

Drawing Library

DrawingManager class

Constructor

Methods

Events

DrawingManagerOptions interface

Properties

DrawingControlOptions interface

Properties

OverlayCompleteEvent interface

Properties

OverlayType constants

Constants