Einführung

Die Routing Engine von pixel.map basiert auf Valhalla und beantwortet Fragen nach Wegen: Route von A nach B, Erreichbarkeit in einer Zeitspanne, Entfernungs- und Zeitmatrizen, Zuordnung roher GPS-Spuren zum Wegenetz, Höhenprofile.

Basis-URL: https://valhalla.pixelmap.at

Was der Dienst kann — fragen Sie ihn selbst

/status ist die verlässlichste Übersicht, weil sie vom laufenden Dienst kommt und nicht aus einer Doku, die altern kann:

curl -H "Authorization: Bearer <IHR-TOKEN>" "https://valhalla.pixelmap.at/status"

{
  "version": "3.8.3",
  "tileset_last_modified": 1788400416,
  "available_actions": ["tile", "status", "centroid", "expansion",
    "transit_available", "trace_attributes", "trace_route", "isochrone",
    "optimized_route", "sources_to_targets", "height", "route", "locate"]
}

Gemessen am 14.09.2026: Valhalla 3.8.3, Kachelstand 03.09.2026.

tileset_last_modified ist praktisch relevant: Es sagt, wie aktuell das Straßennetz ist, auf dem gerechnet wird. Eine Straße, die letzte Woche eröffnet wurde, kennt der Dienst erst nach dem nächsten Kachelbau.

Die Endpunkte dieser Doku

Endpunkt	Frage	Seite
/route	Wie komme ich von A nach B?	Routenberechnung
/isochrone	Was erreiche ich in 20 Minuten?	Isochronen
/sources_to_targets	Wie weit ist jedes A von jedem B?	Matrix
/trace_route	Auf welchen Straßen lag diese GPS-Spur?	Map Matching
/height	Wie hoch liegen diese Punkte?	Höhenprofil

Darüber hinaus meldet /status weitere Aktionen — optimized_route, centroid, expansion, locate, trace_attributes, transit_available. Sie sind hier nicht beschrieben; ihre Aufrufform folgt der Valhalla-Dokumentation.

Anfrageform

Alle Endpunkte nehmen dieselbe Form an — ein JSON-Objekt, entweder als POST-Körper oder als URL-kodierter json-Parameter. Beides ist gemessen gleichwertig:

# POST — für alles außer den kürzesten Anfragen zu bevorzugen
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"}' \
  "https://valhalla.pixelmap.at/route"

# GET — praktisch zum Ausprobieren, aber URL-Längen sind begrenzt
curl -H "Authorization: Bearer <IHR-TOKEN>" "https://valhalla.pixelmap.at/route?json=%7B%22locations%22%3A...%7D"

Sprache der Anweisungen

Textanweisungen kommen standardmäßig auf Englisch. Deutsch bekommen Sie nur, wenn Sie es anfordern:

"directions_options": { "units": "kilometers", "language": "de-DE" }

Gemessen: mit dieser Angabe „Auf Ursulinengasse Richtung Süden fahren.“, ohne sie „Drive south on Ursulinengasse.” Das betrifft /route und /trace_route gleichermaßen.

Zugriff

Die Routing Engine verlangt einen Token, als Header Authorization: Bearer <IHR-TOKEN> oder als Parameter ?token=<IHR-TOKEN>. Die Beispiele setzen den Header. Wie Sie einen Token bekommen und warum er nicht in den Quelltext einer Webseite gehört, steht unter Zugriff auf die Dienste.