Indoor Direction Service
How to calculate and display the shortest route between 2 locations
Woosmap Indoor Js API provides you tools to create an optimized navigation experience:
- Indoor turn-by-turn navigation with Points of Interest
- Routing based on mobility profiles (Handicapped access, travelling with a buggy, walking, etc.)
- Multilingual
Indoor direction service
Use the IndoorService class to calculate the shortest route between 2 locations and display the route on the map thanks to the setDirection()
method of the IndoorRenderer.
Fetching Indoor Direction API
The indoorService.directions() method expects a JSON object that fits with IndoorDirectionRequest interface. The venue identifier, the origin, and the destination are required.
Choose one of the two following ways to define the origin and destination:
Coordinates (latitude, longitude and floor level)
- Set the
origin
property with a LatLng object andoriginLevel
with Integer value. - Set the
destination
property with a LatLng object anddestinationLevel
with Integer value.
POI identifier (id or ref)
- Set
originId
property with theid
or with theref
by prefixing it with"ref:"
. - Set
destinationId
property with theid
or with theref
by prefixing it with"ref:"
.
Displaying the calculated route
The IndoorRenderer provides a method for displaying the calculated route on the map.
Here is a code sample, followed by a live demo in a Parisian railway station:
const indoorService = new window.woosmap.map.IndoorService();
indoorService.directions(
{
venueId: indoorRenderer.getVenue().venue_id,
origin: new woosmap.map.LatLng(x.latlng),
originLevel: 0,
destinationId: "ref:bakery001"
},
(result) => {
indoorRenderer.setDirections(result);
}
);
let map: woosmap.map.Map;
let indoorDirectionsRequest: woosmap.map.IndoorDirectionRequest;
let indoorRenderer: woosmap.map.IndoorRenderer;
let venue: string;
function initMap() {
venue = "gdn_doc";
map = new window.woosmap.map.Map(
document.getElementById("map") as HTMLElement,
{
center: { lat: 43.6066, lng: 3.9218 },
zoom: 19.5,
},
);
indoorRenderer = new woosmap.map.IndoorRenderer({
venue: venue,
});
const indoorService: woosmap.map.IndoorService =
new window.woosmap.map.IndoorService();
// Indoor event that is triggered when the indoor venue is loaded.
indoorRenderer.addListener(
"indoor_venue_loaded",
(venue: woosmap.map.Venue) => {
console.log(venue);
if (indoorRenderer !== null && indoorRenderer.getVenue() !== null) {
indoorDirectionsRequest = {
venueId: indoorRenderer.getVenue()?.venue_id || "gdn_doc",
origin: new woosmap.map.LatLng(48.8801287, 2.3548678),
originLevel: 0,
destination: new woosmap.map.LatLng(48.8799341, 2.3563779),
destinationLevel: 0,
language: "en",
units: "metric",
originId: null,
destinationId: null,
};
indoorService.directions(
indoorDirectionsRequest,
(result: woosmap.map.IndoorDirectionResult) => {
indoorRenderer.setDirections(result);
hideLoader();
},
);
}
},
);
indoorRenderer.setMap(map);
}
const hideLoader = () => {
(document.querySelector(".progress") as HTMLElement).remove();
};
declare global {
interface Window {
initMap: () => void;
}
}
window.initMap = initMap;
let map;
let indoorDirectionsRequest;
let indoorRenderer;
let venue;
function initMap() {
venue = "gdn_doc";
map = new window.woosmap.map.Map(document.getElementById("map"), {
center: { lat: 43.6066, lng: 3.9218 },
zoom: 19.5,
});
indoorRenderer = new woosmap.map.IndoorRenderer({
venue: venue,
});
const indoorService = new window.woosmap.map.IndoorService();
// Indoor event that is triggered when the indoor venue is loaded.
indoorRenderer.addListener("indoor_venue_loaded", (venue) => {
console.log(venue);
if (indoorRenderer !== null && indoorRenderer.getVenue() !== null) {
indoorDirectionsRequest = {
venueId: indoorRenderer.getVenue()?.venue_id || "gdn_doc",
origin: new woosmap.map.LatLng(48.8801287, 2.3548678),
originLevel: 0,
destination: new woosmap.map.LatLng(48.8799341, 2.3563779),
destinationLevel: 0,
language: "en",
units: "metric",
originId: null,
destinationId: null,
};
indoorService.directions(indoorDirectionsRequest, (result) => {
indoorRenderer.setDirections(result);
hideLoader();
});
}
});
indoorRenderer.setMap(map);
}
const hideLoader = () => {
document.querySelector(".progress").remove();
};
window.initMap = initMap;
/*
* Always set the map height explicitly to define the size of the div element
* that contains the map.
*/
#map {
height: 100%;
}
/*
* Optional: Makes the sample page fill the window.
*/
html,
body {
height: 100%;
margin: 0;
padding: 0;
font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, Roboto, Helvetica Neue, Arial, Noto Sans, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol, Noto Color Emoji;
}
#app {
height: 100%;
}
.progress {
position: fixed;
top: 0;
left: 0;
width: 100%;
height: 100%;
background: white;
display: flex;
justify-content: center;
align-items: center;
z-index: 9999;
}
.progress .spinner {
border: 10px solid #f3f3f3;
border-top: 10px solid #444444;
border-radius: 50%;
width: 70px;
height: 70px;
animation: spin 1s linear infinite;
}
<html>
<head>
<title>Indoor Directions Service</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta charset="utf-8" />
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="app">
<div class="progress">
<div class="spinner"></div>
</div>
<!--The div element for the map -->
<div id="map"></div>
</div>
<script
src="https://sdk.woosmap.com/map/map.js?key=woos-48c80350-88aa-333e-835a-07f4b658a9a4&callback=initMap"
defer
></script>
</body>
</html>
Advanced usage of the Indoor direction service
Some optional properties allow you to:
- define the language of instructions
- switch between meter and imperial
- apply a routing profile
- add some waypoints (and choose to order them or not)
- avoid a part of the graph
Find all these optional properties in the reference page: IndoorDirectionRequest interface