Indoor Direction Service

How to calculate and display the shortest route between 2 locations

  1. Indoor direction service

Woosmap Indoor Js API provides you tools to create an optimized navigation experience:

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)

POI identifier (id or 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:

JavaScript
        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);
      }
);

    
Woosmap Indoor Directions sample
        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:

Find all these optional properties in the reference page: IndoorDirectionRequest interface

Was this article helpful?
Have more questions? Submit a request