Map Matching (`/trace_route`)

Ordnet eine rohe GPS-Spur dem Straßennetz zu — aus verrauschten Messpunkten wird ein Weg über echte Straßen, mit Anweisungen wie bei einer Route.

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

Beispiel

curl -H "Authorization: Bearer <IHR-TOKEN>" -X POST -H "Content-Type: application/json" \
  -d '{
    "shape": [
      {"lat": 46.624431, "lon": 14.305519},
      {"lat": 46.624380, "lon": 14.305420},
      {"lat": 46.624295, "lon": 14.305180},
      {"lat": 46.624196, "lon": 14.304708}
    ],
    "costing": "auto",
    "shape_match": "map_snap",
    "directions_options": {"units": "kilometers", "language": "de-DE"}
  }' \
  "https://valhalla.pixelmap.at/trace_route"

Die Antwort hat dieselbe Gestalt wie bei /route: ein trip mit legs, maneuvers und kodierter Polylinie.

Der häufigste Fehler ist die Eingabe, nicht der Dienst

Zu weit auseinanderliegende oder abseits jeder Straße liegende Punkte quittiert der Dienst mit:

{"error_code": 442, "error": "No path could be found for input", "status_code": 400}

Das ist kein Ausfall. Beim Schreiben dieser Seite haben wir es selbst erzeugt: drei frei gewählte Punkte im Abstand von einigen hundert Metern reichten nicht. Mit echten, dicht aufeinanderfolgenden Punkten entlang einer Straße antwortete derselbe Endpunkt sofort mit 200.

Wenn 442 auftritt, prüfen Sie zuerst Ihre Spur: Liegen die Punkte auf befahrbaren Wegen? Sind sie dicht genug? Passt costing zum Weg — eine Wanderspur mit "costing": "auto" findet keine Straße.

shape_match

Wert	Verhalten
map_snap	Der Dienst sucht den wahrscheinlichsten Weg durchs Netz — für verrauschte GPS-Spuren
edge_walk	Die Punkte liegen bereits exakt auf dem Netz; schneller, aber unnachsichtig
walk_or_snap	Erst edge_walk, bei Misserfolg map_snap

Im Zweifel map_snap.

Verwandt: trace_attributes

Wenn Sie nicht die Route, sondern die Eigenschaften der befahrenen Abschnitte brauchen (Straßenname, Klasse, Tempolimit), ist trace_attributes der passende Endpunkt. Er ist verfügbar (siehe /status), hier aber nicht beschrieben — Aufrufform in der Valhalla-Dokumentation.