Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Load Shapefiles onto the Map - 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 easily load shapefiles (.shp, .dbf, .prj) onto the map." />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, ESRI Shapefiles, shapefiles, shp, dbf, OGC" />
<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>
<!-- Load in Shapefile-js library which converts Shapefiles into GeoJSON data. -->
<script src="../Common/scripts/shp.min.js"></script>
<script type='text/javascript'>
var map, datasource, popup;
function GetMap() {
//Point the Azure Maps domain to the US Azure Gov Cloud domain.
//Initialize a map instance.
map = new atlas.Map('myMap', {
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 a style control and add it to the map.
map.controls.add(new atlas.control.StyleControl(), {
position: 'top-right'
//Create a data source to add your data to.
datasource = new atlas.source.DataSource();
//Create a popup.
popup = new atlas.Popup();
//Add a layers for rendering the data.
var layers = [
new atlas.layer.PolygonLayer(datasource, null, {
filter: ['any', ['==', ['geometry-type'], 'Polygon'], ['==', ['geometry-type'], 'MultiPolygon']] //Only render Polygon or MultiPolygon in this layer.
new atlas.layer.LineLayer(datasource, null, {
strokeColor: 'white',
strokeWidth: 2,
filter: ['any', ['==', ['geometry-type'], 'Polygon'], ['==', ['geometry-type'], 'MultiPolygon']] //Only render Polygon or MultiPolygon in this layer.
new atlas.layer.LineLayer(datasource, null, {
strokeColor: 'red',
filter: ['any', ['==', ['geometry-type'], 'LineString'], ['==', ['geometry-type'], 'MultiLineString']] //Only render LineString or MultiLineString in this layer.
new atlas.layer.BubbleLayer(datasource, null, {
filter: ['any', ['==', ['geometry-type'], 'Point'], ['==', ['geometry-type'], 'MultiPoint']] //Only render Point or MultiPoints in this layer.
map.layers.add(layers, 'labels');
//Add a click event to the layers to show a popup of what the user clicked on.'click', layers, featureClicked);
function loadShapeFile(url) {
shp(url).then(function (data) {
//Load the shapefile into the data source and overwrite any existing data.
//Bring the data into view on the map.
padding: 50
function featureClicked(e) {
//Make sure the event occurred on a shape feature.
if (e.shapes && e.shapes.length > 0) {
//By default, show the popup where the mouse event occurred.
var pos = e.position;
var offset = [0, 0];
var properties;
if (e.shapes[0] instanceof atlas.Shape) {
properties = e.shapes[0].getProperties();
//If the shape is a point feature, show the popup at the points coordinate.
if (e.shapes[0].getType() === 'Point') {
pos = e.shapes[0].getCoordinates();
offset = [0, -18];
} else {
properties = e.shapes[0].properties;
//If the shape is a point feature, show the popup at the points coordinate.
if (e.shapes[0].type === 'Point') {
pos = e.shapes[0].geometry.coordinates;
offset = [0, -18];
//Update the content and position of the popup.
//Create a table from the properties in the feature.
content: atlas.PopupTemplate.applyTemplate(properties),
position: pos,
pixelOffset: offset
//Open the popup.;
<body onload="GetMap()">
<div id="myMap" style="position:relative;width:100%;min-width:290px;height:600px;"></div>
<div style="position:absolute;top:10px;left:10px;background-color:white;border-radius:5px;padding:5px;">
Load Shapefile:<br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/cities')" value="Cities" /><br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/')" value="Chicago bike racks" /><br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/US_Interstates')" value="US Interstates" /><br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/greater_london_const_region')" value="Greater London UK Regions (projected)" /><br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/')" value="Polish Administrative Divisions" /><br />
<input type="button" onclick="loadShapeFile('../Common/data/shp/')" value="German Postal Codes (17MB)" />
<fieldset style="width:calc(100% - 30px);min-width:290px;margin-top:10px;">
<legend><h1 style="font-size:16px">Load Shapefiles onto the Map</h1></legend>
This sample shows how to easily load shapefiles (.shp, .dbf, .prj) onto the map.
This sample uses the open source <a href="" target="_blank">Shapefile.js</a> project which converts Shapefiles into GeoJSON which can easily be consumed by the map control.
<br />
<br />
<b>Note:</b> Not all file and mime types are enabled in all servers. If using .NET, it is recommended to add the following to the web.config file:
<br />
<br />
&lt;system.webServer&gt;<br />&nbsp;&nbsp;&lt;staticContent&gt;<br />&nbsp;&nbsp;&nbsp;&nbsp;&lt;mimeMap fileExtension=&quot;.shp&quot; mimeType=&quot;application/octet-stream&quot; /&gt;<br />&nbsp;&nbsp;&nbsp;&nbsp;&lt;mimeMap fileExtension=&quot;.dbf&quot; mimeType=&quot;application/octet-stream&quot; /&gt;<br />&nbsp;&nbsp;&nbsp;&nbsp;&lt;mimeMap fileExtension=&quot;.prj&quot; mimeType=&quot;text/plain&quot; /&gt;<br />&nbsp;&nbsp;&lt;/staticContent&gt;<br />&lt;system.webServer&gt;