New pricing changes went into effect on July 16, 2018. For more information, check out the Guide for Existing Users.

Drawing Library

DrawingManager class

google.maps.drawing.DrawingManager class

Allows users to draw markers, polygons, polylines, rectangles, and circles on the map. The DrawingManager'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.

Library

drawing

Constructor
DrawingManager
DrawingManager([options])
Parameters: 
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
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: 
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: 
Return Value:  None
Attaches the DrawingManager object to the specified Map.
setOptions
setOptions(options)
Parameters: 
Return Value:  None
Sets the DrawingManager's options.
Events
circlecomplete
function(circle)
Arguments: 
This event is fired when the user has finished drawing a circle.
markercomplete
function(marker)
Arguments: 
This event is fired when the user has finished drawing a marker.
overlaycomplete
function(event)
Arguments: 
This event is fired when the user has finished drawing an overlay of any type.
polygoncomplete
function(polygon)
Arguments: 
This event is fired when the user has finished drawing a polygon.
polylinecomplete
function(polyline)
Arguments: 
This event is fired when the user has finished drawing a polyline.
rectanglecomplete
function(rectangle)
Arguments: 
This event is fired when the user has finished drawing a rectangle.

DrawingManagerOptions interface

google.maps.drawing.DrawingManagerOptions interface

Options for the drawing manager.

Library

drawing

Properties
circleOptions
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.
drawingControl
Type:  boolean
The enabled/disabled state of the drawing control. Defaults to true.
drawingControlOptions
The display options for the drawing control.
drawingMode
Type:  OverlayType
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.
map
Type:  Map
The Map to which the DrawingManager is attached, which is the Map on which the overlays created will be placed.
markerOptions
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.
polygonOptions
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.
polylineOptions
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.
rectangleOptions
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.

Library

drawing

Properties
drawingModes
Type:  Array<OverlayType>
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. Defaults to ['marker', 'polyline', 'rectangle', 'circle', 'polygon'].
position
Position id. Used to specify the position of the control on the map. The default position is TOP_LEFT.

OverlayCompleteEvent interface

google.maps.drawing.OverlayCompleteEvent interface

The properties of an overlaycomplete event on a DrawingManager.

Library

drawing

Properties
overlay
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 the DrawingManager. Specify these by value, or by using the constant's name. For example, 'polygon' or google.maps.drawing.OverlayType.POLYGON.

Library

drawing

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.

다음에 대한 의견 보내기...

Maps JavaScript API
도움이 필요하시나요? 지원 페이지를 방문하세요.