Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Reusing Popup with Multiple Pins - 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 popups that contain media content." />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, pins, symbols, pushpins, markers, infobox, infowindow, optimization, popup" />
<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, popup;
//Define an HTML template for a custom popup content laypout.
var simplePopupTemplate = '<div class="customInfobox"><div class="name">{name}</div>{description}</div>';
function GetMap() {
//Point the Azure Maps domain to the US Azure Gov Cloud domain.
//Initialize a map instance.
map = new atlas.Map('myMap', {
center: [-122.33, 47.62],
zoom: 11,
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 data source and add it to the map.
datasource = new atlas.source.DataSource(null, {
cluster: true
//Create three point features on the map and add some metadata in the properties which we will want to display in a popup.
var point1 = new[-122.33, 47.6]), {
name: 'Point 1 Title',
description: 'This is the description 1.'
var point2 = new[-122.335, 47.645]), {
name: 'Point 2 Title',
description: 'This is the description 2.'
var point3 = new[-122.325, 47.635]), {
name: 'Point 3 Title',
description: 'This is the description 3.'
//Add the symbol to the data source.
datasource.add([point1, point2, point3]);
//Add a layer for rendering point data as symbols.
var symbolLayer = new atlas.layer.SymbolLayer(datasource);
//Create a popup but leave it closed so we can update it and display it later.
popup = new atlas.Popup({
position: [0, 0],
pixelOffset: [0, -18]
//Add a click event to the symbol layer.'click', symbolLayer, symbolClicked);
function symbolClicked(e) {
//Make sure the event occurred on a point feature.
if (e.shapes && e.shapes.length > 0) {
var content, coordinate;
//Check to see if the first value in the shapes array is a Point Shape.
if (e.shapes[0] instanceof atlas.Shape && e.shapes[0].getType() === 'Point') {
var properties = e.shapes[0].getProperties();
content = simplePopupTemplate.replace(/{name}/g,{description}/g, properties.description);
coordinate = e.shapes[0].getCoordinates();
} else if (e.shapes[0].type === 'Feature' && e.shapes[0].geometry.type === 'Point') {
//Check to see if the feature is a cluster.
if (e.shapes[0].properties.cluster) {
content = '<div style="padding:10px;">Cluster of ' + e.shapes[0].properties.point_count + ' symbols</div>';
} else {
//Feature is likely from a VectorTileSource.
content = simplePopupTemplate.replace(/{name}/g,{description}/g, properties.description);
coordinate = e.shapes[0].geometry.coordinates;
if (content && coordinate) {
//Populate the popupTemplate with data from the clicked point feature.
//Update the content of the popup.
content: content,
//Update the position of the popup with the symbols coordinate.
position: coordinate
//Open the popup.;
/* CSS styles used by custom popup template */
.customInfobox {
max-width: 200px;
padding: 10px;
font-size: 12px;
.customInfobox .name {
font-size: 14px;
font-weight: bold;
margin-bottom: 5px;
<body onload="GetMap()">
<div id="myMap" style="position:relative;width:100%;min-width:290px;height:600px;"></div>
<fieldset style="width:calc(100% - 30px);min-width:290px;margin-top:10px;">
<legend><h1 style="font-size:16px">Reusing Popup with Multiple Points</h1></legend>
When you have a lot of points and only want to show one popup at a time, the best approach is to create one popup and reuse
it rather than creating a popup for each point feature. By doing this the number of DOM elements created by the application is greatly
reduced which can provide better performance. This sample creates 3 point features. If you click on any
of them, a popup will be displayed with the content for that point feature.