Page Summary
-
This example demonstrates how to enable drawing tools on a Google Map, allowing users to draw shapes like markers, circles, polygons, polylines, and rectangles directly on the map.
-
The Drawing library is required and should be included when loading the Google Maps API using the
libraries=drawingparameter. -
The drawing tools are activated and customized using the
google.maps.drawing.DrawingManagerobject, which provides options for controlling the drawing mode, appearance, and behavior of the drawn shapes. -
The example provides code snippets in both TypeScript and JavaScript, showcasing how to initialize the map and drawing tools within the
initMapfunction. -
Users can clone and run the sample locally using Git and Node.js, or try it directly on JSFiddle or Google Cloud Shell via the provided links.
This example creates a map with drawing tools enabled.
Read the documentation .
TypeScript
// This example requires the Drawing library. Include the libraries=drawing // parameter when you first load the API. For example: // <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=drawing"> function initMap () : void { const map = new google . maps . Map ( document . getElementById ( "map" ) as HTMLElement , { center : { lat : - 34.397 , lng : 150.644 }, zoom : 8 , } ); const drawingManager = new google . maps . drawing . DrawingManager ({ drawingMode : google.maps.drawing.OverlayType.MARKER , drawingControl : true , drawingControlOptions : { position : google.maps.ControlPosition.TOP_CENTER , drawingModes : [ google . maps . drawing . OverlayType . MARKER , google . maps . drawing . OverlayType . CIRCLE , google . maps . drawing . OverlayType . POLYGON , google . maps . drawing . OverlayType . POLYLINE , google . maps . drawing . OverlayType . RECTANGLE , ], }, markerOptions : { icon : "https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png" , }, circleOptions : { fillColor : "#ffff00" , fillOpacity : 1 , strokeWeight : 5 , clickable : false , editable : true , zIndex : 1 , }, }); drawingManager . setMap ( map ); } declare global { interface Window { initMap : () = > void ; } } window . initMap = initMap ;
JavaScript
// This example requires the Drawing library. Include the libraries=drawing // parameter when you first load the API. For example: // <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=drawing"> function initMap () { const map = new google . maps . Map ( document . getElementById ( "map" ), { center : { lat : - 34.397 , lng : 150.644 }, zoom : 8 , }); const drawingManager = new google . maps . drawing . DrawingManager ({ drawingMode : google . maps . drawing . OverlayType . MARKER , drawingControl : true , drawingControlOptions : { position : google . maps . ControlPosition . TOP_CENTER , drawingModes : [ google . maps . drawing . OverlayType . MARKER , google . maps . drawing . OverlayType . CIRCLE , google . maps . drawing . OverlayType . POLYGON , google . maps . drawing . OverlayType . POLYLINE , google . maps . drawing . OverlayType . RECTANGLE , ], }, markerOptions : { icon : "https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png" , }, circleOptions : { fillColor : "#ffff00" , fillOpacity : 1 , strokeWeight : 5 , clickable : false , editable : true , zIndex : 1 , }, }); drawingManager . setMap ( map ); } window . initMap = initMap ;
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ # map { height : 100 % ; } /* * Optional: Makes the sample page fill the window. */ html , body { height : 100 % ; margin : 0 ; padding : 0 ; }
HTML
<html> <head> <title>Drawing Tools</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- The `defer` attribute causes the script to execute after the full HTML document has been parsed. For non-blocking uses, avoiding race conditions, and consistent behavior across browsers, consider loading using Promises. See https://developers.google.com/maps/documentation/javascript/load-maps-js-api for more information. --> <script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&libraries=drawing&v=weekly" defer ></script> </body> </html>
Try Sample
Clone Sample
Git and Node.js are required to run this sample locally. Follow these instructions to install Node.js and NPM. The following commands clone, install dependencies and start the sample application.
git clone - b sample - drawing - tools https : //github.com/googlemaps/js-samples.gitcd js - samplesnpm inpm start
Other samples can be tried by switching to any branch beginning with sample- SAMPLE_NAME
.
git checkout sample - SAMPLE_NAMEnpm inpm start
