Get a Maps Demo Key: Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Drawing Tools

Spark icon

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=drawing parameter.
The drawing tools are activated and customized using the google.maps.drawing.DrawingManager object, 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 initMap function.
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">
functioninitMap():void{
constmap=newgoogle.maps.Map(
document.getElementById("map")asHTMLElement,
{
center:{lat:-34.397,lng:150.644},
zoom:8,
}
);
constdrawingManager=newgoogle.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);
}
declareglobal{
interfaceWindow{
initMap:()=>void;
}
}
window.initMap=initMap;index.ts

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">
functioninitMap(){
constmap=newgoogle.maps.Map(document.getElementById("map"),{
center:{lat:-34.397,lng:150.644},
zoom:8,
});
constdrawingManager=newgoogle.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;index.js

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;
}
style.css

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>index.html

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.

gitclone-bsample-drawing-toolshttps://github.com/googlemaps/js-samples.git
cdjs-samples
npmi
npmstart

Other samples can be tried by switching to any branch beginning with sample-SAMPLE_NAME.

gitcheckoutsample-SAMPLE_NAME
npmi
npmstart