Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Create a measuring tool - Azure Maps Web SDK Samples</title>
<meta charset="utf-8" />
<link rel="shortcut icon" href="/favicon.ico"/>
<meta http-equiv="x-ua-compatible" content="IE=Edge" />
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
<meta name="description" content="This sample shows how to use the drawing tools to measure distances and areas. " />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, drawing tools, circle, rectangle, polygon, paint, events, measuring tape, measure" />
<meta name="author" content="Microsoft Azure Maps" />
<!-- Add references to the Azure Maps Map control JavaScript and CSS files. -->
<link rel="stylesheet" href="" type="text/css" />
<script src=""></script>
<!-- Add references to the Azure Maps Map Drawing Tools JavaScript and CSS files. -->
<link rel="stylesheet" href="" type="text/css" />
<script src=""></script>
<script type='text/javascript'>
var map, datasource, drawingManager;
function GetMap() {
//Point the Azure Maps domain to the US Azure Gov Cloud domain.
//Initialize a map instance.
map = new atlas.Map('myMap', {
center: [-90, 35],
zoom: 3,
view: 'Auto',
//Add authentication details for connecting to Azure Maps.
authOptions: {
//Use Azure Active Directory authentication.
authType: 'anonymous',
clientId: 'c9f2f391-13f1-407b-a4a5-f0a241bacfbf', //Your Azure Active Directory client id for accessing your Azure Maps account.
getToken: function (resolve, reject, map) {
//URL to your authentication service that retrieves an Azure Active Directory Token.
var tokenServiceUrl = '';
fetch(tokenServiceUrl).then(r => r.text()).then(token => resolve(token));
//Alternatively, use an Azure Maps key. Get an Azure Maps key at NOTE: The primary key should be used as the key.
//authType: 'subscriptionKey',
//subscriptionKey: '<Your Azure Maps Key>'
//Wait until the map resources are ready.'ready', function () {
//Create an instance of the drawing manager and display the drawing toolbar.
drawingManager = new atlas.drawing.DrawingManager(map, {
toolbar: new atlas.control.DrawingToolbar({
buttons: ['draw-line', 'draw-polygon', 'draw-rectangle', 'draw-circle', 'edit-geometry'],
position: 'top-right',
style: 'light'
//Clear the map and drawing canvas when the user enters into a drawing mode.'drawingmodechanged', drawingManager, drawingModeChanged);
//Monitor for when a polygon drawing has been completed.'drawingchanging', drawingManager, measureShape); //Fires when in shape preview is shown.'drawingchanged', drawingManager, measureShape); //Fires when the shape has changed.'drawingcomplete', drawingManager, drawingComplete); //Fires when drawing is completed.
function drawingModeChanged(mode) {
//Clear the drawing canvas when the user enters into a drawing mode.
if (mode.startsWith('draw')) {
document.getElementById('measurementInfo').innerHTML = '';
function drawingComplete(shape) {
//Exit drawing mode.
drawingManager.setOptions({ mode: 'idle' });
function measureShape(shape) {
var msg = '';
//If the search area is a circle, create a polygon from its circle coordinates.
if (shape.isCircle()) {
var r = atlas.math.convertDistance(shape.getProperties().radius, 'meters', 'miles', 2);
var a = Math.round(2 * Math.PI * r * r * 100) / 100;
var p = Math.round(2 * Math.PI * r * 100) / 100;
msg = `Radius: ${r} mi<br/>Area: ${a} sq mi<br/>Perimeter: ${p} mi`;
} else {
var g = shape.toJson().geometry;
var polygon;
switch (shape.getType()) {
case 'LineString':
var l = Math.round(atlas.math.getLengthOfPath(g.coordinates, 'miles') * 100) / 100;
msg += `Length: ${l} mi`;
//Polygon's are rendered as lines when initially being drawn.
if (drawingManager.getOptions().mode === 'draw-polygon') {
polygon = new;
case 'Polygon':
polygon = g;
var p = Math.round(atlas.math.getLengthOfPath(g.coordinates[0], 'miles') * 100) / 100;
msg = `Perimeter: ${p} mi`;
if (polygon) {
msg += `<br/>Area: ${atlas.math.getArea(polygon, 'squareMiles', 2)} sq mi`;
document.getElementById('measurementInfo').innerHTML = msg;
<body onload="GetMap()">
<div id="myMap" style="position:relative;width:100%;min-width:290px;height:600px;"></div>
<div id="measurementInfo" style="position:absolute;top:10px;left:10px;background-color:white;border-radius:10px;padding:10px;"></div>
<fieldset style="width:calc(100% - 30px);min-width:290px;margin-top:10px;">
<legend><h1 style="font-size:16px">Create a measuring tool</h1></legend>
This sample shows how to use the drawing tools to measure distances and areas.