How to Enable Basic Routing with OpenRouteService (ORS) in OpenTopoMap Viewer

OpenTopoMap Viewer is a lightweight Android app for outdoor navigation and offline maps. With OpenRouteService (ORS) integration, you can calculate routes directly on the map for hiking, cycling, driving, and more. This guide shows you how to enable basic routing step by step.


1. Register for an ORS API Key

To use routing in OpenTopoMap Viewer, you need an API key from HeiGIT:

  1. Go to account.heigit.org.
  2. Create a free account.
  3. Generate a new API key and select the Basic plan.

👉 For more details, see: How to make an API token (HeiGIT/ORS).


2. Add Your API Key in OpenTopoMap Viewer

  1. Open OpenTopoMap Viewer.
  2. Go to Settings → OpenRouteService (ORS).
  3. Tap the HeiGIT URL to copy your API key.
  4. Paste the key into the API key input field.

OpenTopoMap Viewer settings screen showing OpenRouteService API key input field


3. Select Your Routing Profile

After adding your API key, a new setting becomes available: Routing profile.

  • Open Settings → Routing profile.
  • Choose your transportation mode: 🚶 Walking, 🚴 Cycling, 🚗 Driving.

Select routing profile such as walking, cycling, or driving in OpenTopoMap Viewer


4. Plan a Route on the Map

  1. Return to the map view.
  2. Long-press on the map to place a marker.
  3. Tap the marker to open its info balloon.
  4. Tap the “add waypoint” icon in the top-right corner.

A route will be calculated from your current location to the marker position using OpenRouteService.

Map view in OpenTopoMap Viewer with a marker added by long-press (Schwanenburg, Kleve)

Marker balloon with add waypoint icon for route calculation

Calculated route displayed on map in OpenTopoMap Viewer


Conclusion

That’s it! You’ve enabled basic routing with ORS in OpenTopoMap Viewer. With your free HeiGIT API key, you can now plan outdoor trips, hiking tours, and bike rides directly within the app.

  • ✅ Register at account.heigit.org
  • ✅ Add your API key in Settings → OpenRouteService
  • ✅ Select your routing profile
  • ✅ Long-press on the map to calculate your first route