Source: https://developers.woosmap.com/products/indoor-api/guides/direction-service/

> For clean Markdown of any page, append `.md` to the page URL.

> For a complete documentation index, see https://developers.woosmap.com/llms.txt

# Indoor Direction Service



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](/products/indoor-api/indoor-js-api/reference/#woosmap.map.IndoorService) 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](/products/indoor-api/indoor-js-api/reference/#woosmap.map.IndoorDirectionRequest). 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 and `originLevel` with Integer value.
- Set the `destination` property with a LatLng object and `destinationLevel` with Integer value.

**POI identifier (id or ref)**

- Set `originId` property with the `id` or with the `ref` by prefixing it with `"ref:"`.
- Set `destinationId` property with the `id` or with the `ref` 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:

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

https://demo.woosmap.com/js-samples/samples/indoor-directions-service/app/dist/
[](https://demo.woosmap.com/js-samples/samples/indoor-directions-service/highlight/highlight.html "Open in new tab with highlighted code")
Try sample 

- [CodeSandbox](https://codesandbox.io/p/devbox/github/woosmap/js-samples/tree/master/dist/samples/indoor-directions-service/app?file=index.ts)
- [JsFiddle](https://jsfiddle.net/gh/get/library/pure/woosmap/js-samples/tree/master/dist/samples/indoor-directions-service/jsfiddle)
- [Clone on Github](https://github.com/Woosmap/js-samples/tree/sample/indoor-directions-service)

```typescript
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;
```

```javascript
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;
```

```css
/*
 * 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
<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>
```

### Routing Profiles

Routing profiles enable customized navigation for different user types:

- **Default** : Standard walking routes
- **Accessible** : Wheelchair-friendly paths (ramps, elevators only)
- **Staff** : Access to restricted areas and shortcuts
- **Premium** : Priority paths for VIP customers
- **Emergency** : Fastest evacuation routes

### Level Changes

Indoor navigation supports multiple types of level changes:

- **Stairs** : Standard stairways
- **Escalators** : Moving stairs
- **Elevators** : Lifts for any level
- **Ramps** : Accessible inclines
- **Custom** : Venue-specific transitions

### 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](/products/indoor-api/indoor-js-api/reference/#woosmap.map.IndoorDirectionRequest)