Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Introduction to Spatial Math - 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 many of the built in spatial math functions in the Azure Maps web control." />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, geospatial, spatial math, math, haversine, heading, bearing" />
<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>
<script type='text/javascript'>
var map, datasource;
function GetMap() {
//Point the Azure Maps domain to the US Azure Gov Cloud domain.
//Initialize a map instance.
map = new atlas.Map('myMap', {
center: [-100, 40],
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 two test points.
var startPosition = [-122.33, 47.6];
var endPosition = [-80.225, 25.9];
var startPoint = new, {
title: 'Start'
var endPoint = new, {
title: 'End'
//Calculate a geodesic path between the two points (line that follows curvature of the earth).
var path = atlas.math.getGeodesicPath([startPosition, endPosition]);
var poly = new;
//Calculate the midpoint of the line.
var midPoint = atlas.math.interpolate(startPosition, endPosition);
var pin = new, {
title: 'Midpoint'
//Calculate a location that is along the path 300 miles from the north west coordinate.
var point300MilesFromNW = atlas.math.getPositionAlongPath(poly, 300, 'miles');
var pin2 = new, {
title: '300 miles from NW'
//Create a data source and add it to the map.
datasource = new atlas.source.DataSource();
//Add the data to the data source.
datasource.add([poly, startPoint, endPoint, pin, pin2]);
//Add a layer for rendering line data.
new atlas.layer.LineLayer(datasource, null, {
strokeColor: 'purple',
strokeWidth: 4
//Add a layer for rendering point data.
new atlas.layer.SymbolLayer(datasource, null, {
iconOptions: {
allowOverlap: true,
ignorePlacement: true
textOptions: {
textField: ['get', 'title'],
offset: [0, 1]
filter: ['any', ['==', ['geometry-type'], 'Point'], ['==', ['geometry-type'], 'MultiPoint']] //Only render Point or MultiPoints in this layer.
//Calculate the distance from the northWest coordinate to the southEast coordinate.
var distance = atlas.math.getDistanceTo(startPosition, endPosition, 'miles');
//Calculate the heading from the northWest coordinate to the southEast coordinate.
var heading = atlas.math.getHeading(startPosition, endPosition);
document.getElementById('outputPanel').innerHTML = 'Distance: ' + distance + ' miles<br/>Heading: ' + heading + ' degrees';
<body onload="GetMap()">
<div id="myMap" style="position:relative;width:100%;min-width:290px;height:600px;"></div><br />
<div id="outputPanel"></div>
<fieldset style="width:calc(100% - 30px);min-width:290px;margin-top:10px;">
<legend><h1 style="font-size:16px">Introduction to Spatial Math</h1></legend>
This sample shows how to use many of the built in spatial math functions in the Azure Maps web control.