Routenberechnung (`/route`)

Berechnet einen Weg zwischen zwei oder mehr Punkten samt Abbiegeanweisungen.

POST https://valhalla.pixelmap.at/route

Beispiel

Klagenfurt → Villach, mit dem Auto, Anweisungen auf Deutsch:

curl -H "Authorization: Bearer <IHR-TOKEN>" -X POST -H "Content-Type: application/json" \
  -d '{
    "locations": [
      {"lat": 46.6247, "lon": 14.3053},
      {"lat": 46.6103, "lon": 13.8558}
    ],
    "costing": "auto",
    "directions_options": {"units": "kilometers", "language": "de-DE"}
  }' \
  "https://valhalla.pixelmap.at/route"

Gemessen am 14.09.2026: 39,0 km, 34,6 min, erste Anweisung „Auf Ursulinengasse Richtung Süden fahren.”

Antwort

{
  "trip": {
    "status": 0,
    "status_message": "Found route between points",
    "units": "kilometers",
    "summary": { "length": 39.007, "time": 2077 },
    "legs": [
      {
        "shape": "…",
        "maneuvers": [
          { "type": 1, "instruction": "Auf Ursulinengasse Richtung Süden fahren.", "length": 0.1, "time": 12 }
        ]
      }
    ]
  }
}

Feld	Bedeutung
trip.status	0 = Route gefunden
trip.summary.length	Länge in der unter units genannten Einheit
trip.summary.time	Fahrzeit in Sekunden
legs[].shape	Die Geometrie als kodierte Polylinie
legs[].maneuvers	Die Abbiegeanweisungen der Reihe nach

Die Polylinie hat Präzision 6, nicht 5

legs[].shape ist eine kodierte Polylinie — aber mit sechs Nachkommastellen, während die verbreiteten Decoder (Google-Standard) fünf annehmen. Mit der falschen Präzision liegt Ihre Route um den Faktor 10 daneben, und zwar ohne Fehlermeldung: Sie bekommen eine Linie, sie liegt nur im Nichts.

Gemessen: die Route Klagenfurt–Villach enthält 746 Punkte.

Fortbewegungsarten (costing)

auto, bicycle, pedestrian, truck, motorcycle, bus und weitere — die vollständige Liste samt Feinsteuerung (costing_options) steht in der Valhalla-Dokumentation.

Ein unbekannter Wert wird klar quittiert:

{"error_code": 125, "error": "No costing method found: 'gibtesnicht'", "status_code": 400}

Mehr als zwei Punkte

locations nimmt beliebig viele Zwischenziele; die Route führt in der angegebenen Reihenfolge durch alle. Soll der Dienst die Reihenfolge optimieren, ist optimized_route der passende Endpunkt — er ist verfügbar (siehe /status), hier aber nicht beschrieben.