Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Show popup on hover - 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 show a popup when the mouse hovers over or touches a shape." />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, pins, symbols, pushpins, markers, infobox, infowindow, hover" />
<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, symbolLayer;
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.63],
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();
//Create three point features on the map and add some metadata in the properties which we will want to display in a popup.
new[-122.33, 47.6]), {
name: 'Point 1 Title',
description: 'This is the description 1.'
new[-122.335, 47.645]), {
name: 'Point 2 Title',
description: 'This is the description 2.'
new[-122.325, 47.635]), {
name: 'Point 3 Title',
description: 'This is the description 3.'
//Add a layer for rendering point data as symbols.
symbolLayer = new atlas.layer.SymbolLayer(datasource, null, { iconOptions: { allowOverlap: true } });
//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]
//Close the popup when the mouse moves on the map.'mousemove', closePopup);
* Open the popup on mouse move or touchstart on the symbol layer.
* Mouse move is used as mouseover only fires when the mouse initially goes over a symbol.
* If two symbols overlap, moving the mouse from one to the other won't trigger the event for the new shape as the mouse is still over the layer.
*/'mousemove', symbolLayer, symbolHovered);'touchstart', symbolLayer, symbolHovered);
function closePopup() {
function symbolHovered(e) {
//Make sure the event occurred on a shape feature.
if (e.shapes && e.shapes.length > 0) {
var properties = e.shapes[0].getProperties();
//Update the content and position of the popup.
//Create the content of the popup.
content: `<div style="padding:10px;"><b>${}</b><br/>${properties.description}</div>`,
position: e.shapes[0].getCoordinates(),
pixelOffset: [0, -18]
//Open the popup.;
<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">Show popup on hover</h1></legend>
This sample shows how to show a popup when the mouse hovers over or touches a shape.
This sample uses the mouse move event to detect when hovering over a shape instead of the mouse over event.
The mouse enter and over events only fires when initially hovering over a shape in a layer.
If two shapes overlap, these events won't fire again. The mouse move event will fire while moving the mouse over shapes in the layer.