Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time
<!DOCTYPE html>
<html lang="en">
<title>Fuzzy Search with Services Module - 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 Services module for Azure Maps to perform a fuzzy search for points of interests, address, and places. Providing user location information allows the search service choose results that are more local to the user." />
<meta name="keywords" content="Microsoft maps, map, gis, API, SDK, services, module, geolocation, search, fuzzy, geocode, geocoding, points of interest, POI, address, addresses, places" />
<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 a reference to the Azure Maps Services Module JavaScript file. -->
<script src=""></script>
<script type='text/javascript'>
var map, searchURL, 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>'
//Use MapControlCredential to share authentication between a map control and the service module.
var pipeline = atlas.service.MapsURL.newPipeline(new atlas.service.MapControlCredential(map));
//Create an instance of the SearchURL client and point to the US Azure Gov Cloud domain.
searchURL = new atlas.service.SearchURL(pipeline, '');
//Wait until the map resources are ready.'ready', function () {
//Create a data source and add it to the map.
datasource = new atlas.source.DataSource();
//Add a layer for rendering the results as symbols.
var resultsLayer = 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 results symbol layer.'click', resultsLayer, symbolClicked);
function closePopup() {
function search(userLatitude, userLongitude) {
var query = document.getElementById('input').value;
//Remove any previous results from the map.
searchURL.searchFuzzy(atlas.service.Aborter.timeout(10000), query, {
lat: userLatitude,
lon: userLongitude,
radius: 100000,
view: 'Auto'
}).then(results => {
//Get the results in GeoJSON format and add it to the data source.
var data = results.geojson.getFeatures();
//Set the camera to the bounds of the results.
bounds: data.bbox,
padding: 40
function searchWithUserLocation() {
//Using the HTML5 geolocation API, request the users location from the browser, this will display a prompt to the user to share their location.
navigator.geolocation.getCurrentPosition(function (position) {
//Pass in the user location into the search.
search(position.coords.latitude, position.coords.longitude);
}, function (error) {
//If unable to get the users location, fall back to a search without their location information.
function symbolClicked(e) {
//Make sure the event occurred on a point feature.
if (e.shapes && e.shapes.length > 0 && e.shapes[0].getType() === 'Point') {
var properties = e.shapes[0].getProperties();
//Using the properties, create HTML to fill the popup with useful information.
var html = ['<div style="padding:10px;"><span style="font-size:14px;font-weight:bold;">'];
var addressInTitle = false;
if (properties.type === 'POI' && properties.poi && {
} else if (properties.address && properties.address.freeformAddress) {
addressInTitle = true;
if (!addressInTitle && properties.address && properties.address.freeformAddress) {
html.push(properties.address.freeformAddress, '<br/>');
html.push('<b>Type: </b>', properties.type, '<br/>');
if (properties.entityType) {
html.push('<b>Entity Type: </b>', properties.entityType, '<br/>');
if (properties.type === 'POI' && properties.poi) {
if ( {
html.push('<b>Phone: </b>',, '<br/>');
if (properties.poi.url) {
html.push('<b>URL: </b>', properties.poi.url, '<br/>');
if (properties.poi.classifications) {
for (var i = 0; i < properties.poi.classifications.length; i++) {
for (var j = 0; j < properties.poi.classifications[i].names.length; j++) {
html.push(' - ', properties.poi.classifications[i].names[j].name, '<br/>');
//Set the popup options.
//Update the content of the popup.
content: html.join(''),
//Update the position of the popup with the pins coordinate.
position: e.shapes[0].getCoordinates()
//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:15px;left:15px;background-color:white;padding:10px;border-radius:10px;">
<input type="text" id="input" value="New York" />
<input type="button" onClick="search()" value="Search" />
<input type="button" onClick="searchWithUserLocation()" value="Search with User Location" />
<fieldset style="width:calc(100% - 30px);min-width:290px;margin-top:10px;">
<legend><h1 style="font-size:16px">Fuzzy Search with Services Module</h1></legend>
This sample shows how to use the Services module for Azure Maps to perform a fuzzy search for points of interests, address, and places.
Providing user location information allows the search service choose results that are more local to the user.
Click any results to see a popup with details for that result.