{"id":7845,"date":"2026-10-30T14:48:26","date_gmt":"2026-10-30T14:48:26","guid":{"rendered":"https:\/\/staging.maptoolkit.com\/api\/map-matching-api\/"},"modified":"2026-11-06T15:17:05","modified_gmt":"2026-11-06T15:17:05","slug":"map-matching-api","status":"publish","type":"page","link":"https:\/\/staging.maptoolkit.com\/de\/api\/map-matching-api\/","title":{"rendered":"Map Matching API"},"content":{"rendered":"\n
\n
\n
\nMap Matching API<\/span>\n\n

Saubere Routen aus GPS-Aufzeichnungen.<\/mark><\/h1>\n\n

Smartphones und GPS-Ger\u00e4te zeichnen Tracks auf, die oft mehrere Meter danebenliegen: sie schneiden Kurven ab, springen zwischen Stra\u00dfen hin und her oder landen im Fluss. Die Map Matching API legt jede Aufzeichnung zur\u00fcck auf die Stra\u00dfen und Wege, auf denen sie entstanden ist.<\/p>\n\n

\n
\nDemo buchen<\/a>\n\n<\/svg><\/span>Zur Dokumentation<\/span><\/a>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
\"\"<\/polyline><\/polyline><\/polyline><\/g><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/span><\/span><\/span>Vom Smartphone aufgezeichnet<\/span><\/span><\/span>Nach dem Map Matching<\/span><\/span><\/span><\/div>\n<\/figure>\n<\/div>\n<\/section>\n\n
\n
\n
\nWas Map Matching macht<\/span>\n\n

Von der wackeligen Linie zur Route.<\/mark><\/h2>\n\n

Die API vergleicht die Aufzeichnung mit den Stra\u00dfen und Wegen in der Umgebung und ermittelt, welche davon tats\u00e4chlich genutzt wurden. Drei Dinge \u00e4ndern sich:<\/p>\n<\/div>\n\n

\n
\n
\"\"<\/polyline><\/polyline><\/polyline><\/g><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/g><\/svg><\/div>\n\n
\n

Zur\u00fcck auf dem Weg<\/h3>\n\n

Punkte, die in einen Fluss, ein Geb\u00e4ude oder die Nachbarstra\u00dfe abdriften, werden zur\u00fcck auf den Weg gelegt, der tats\u00e4chlich gegangen oder gefahren wurde.<\/p>\n<\/div>\n<\/div>\n\n

\n
\"\"<\/polyline><\/polyline><\/polyline><\/g><\/svg><\/span><\/span><\/span><\/span>Aufzeichnung<\/span>5,57 km<\/span><\/span><\/span>Abgeglichen<\/span>5,39 km<\/span><\/span><\/span><\/div>\n\n
\n

Die echte Distanz<\/h3>\n\n

Eine wackelige Aufzeichnung verl\u00e4uft im Zickzack und f\u00e4llt l\u00e4nger aus als der Weg selbst. Die abgeglichene Route misst die Stra\u00dfen und Wege, die tats\u00e4chlich genutzt wurden.<\/p>\n<\/div>\n<\/div>\n\n

\n
\"\"<\/polyline><\/polyline><\/polyline><\/g><\/svg>Rechts abbiegen in die Herzog-Friedrich-Stra\u00dfe<\/span>Rechts abbiegen in die Hofgasse<\/span>Leicht links abbiegen in die Pfarrgasse<\/span><\/span><\/div>\n\n
\n

Abbiegehinweise und Stra\u00dfennamen<\/h3>\n\n

Die saubere Route enth\u00e4lt Abbiegehinweise und Stra\u00dfennamen, die einer reinen Aufzeichnung fehlen.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n

\n
\n
\n
\nLive-Demo<\/span>\n\n

Gleichen Sie Ihre eigene Aufzeichnung ab.<\/mark><\/h2>\n\n

Eine Radtour durch die Grachten von Amsterdam, mit dem Smartphone aufgezeichnet und bereits den richtigen Stra\u00dfen zugeordnet. Laden Sie Ihren eigenen Track hoch oder zeichnen Sie einen auf der Karte.<\/p>\n\n

\n
\n<\/svg><\/span><\/span>\n\n

Laden Sie eine GPX-, KML- oder GeoJSON-Datei hoch<\/p>\n<\/div>\n\n

\n<\/svg><\/span><\/span>\n\n

Oder klicken Sie einen Track in die Karte<\/p>\n<\/div>\n\n

\n<\/svg><\/span><\/span>\n\n

Gleichen Sie ihn f\u00fcr Radfahren, Gehen oder Autofahren ab<\/p>\n<\/div>\n<\/div>\n<\/div>\n\n

\"\"<\/polyline><\/polyline><\/polyline><\/g><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/circle><\/g><\/svg>
\n
\n
\nF\u00fcr Entwickler<\/span>\n\n

Aufzeichnung senden, Route erhalten.<\/mark><\/h2>\n\n

Senden Sie die URL einer GPX-Datei oder die aufgezeichneten Punkte an die API. Die Antwort hat dasselbe Format wie bei der Routing API. Alles, was bereits eine Route anzeigt, kann also auch die abgeglichene anzeigen.<\/p>\n\n

\n<\/svg><\/span>Map Matching API in der Dokumentation<\/span><\/a>\n<\/div>\n<\/div>\n\n
\n
\nDer Spaziergang oben auf der Seite<\/span>
const<\/span> body = new<\/span> URLSearchParams({\n  gpx: \"https:\/\/docs.maptoolkit.com\/demos\/innsbruck-walk.gpx\"<\/span>,\n  routeType: \"foot\"<\/span>\n});\nconst<\/span> res = await<\/span> fetch(\n  \"https:\/\/routing.maptoolkit.net\/match?api_key=YOUR_API_KEY\"<\/span>,\n  { method: \"POST\"<\/span>, body }\n);\nconst<\/span> route = (await<\/span> res.json()).paths[0];<\/code><\/pre>\n<\/div>\n\n
Das Ergebnis ist die dunkelblaue Route in den Karten oben: 5,39 km Stra\u00dfen und Wege.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
\n<\/svg><\/span><\/span>\n\n
\n
Eine GPX-Datei oder eine Liste von Punkten<\/h3>\n\n
Geben Sie die URL einer GPX-Datei an oder senden Sie die aufgezeichneten Punkte in ihrer Reihenfolge (point).<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Dieselbe Antwort wie bei der Routing API<\/h3>\n\n
Linie, Distanz, Zeit und Abbiegehinweise, im selben Format wie bei einer berechneten Route.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Lange Aufzeichnungen per POST<\/h3>\n\n
Eine echte Aufzeichnung hat Hunderte Punkte, deshalb geh\u00f6rt sie in den Body der Anfrage.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Planen Sie etwas Zeit ein<\/h3>\n\n
Der Abgleich dauert l\u00e4nger als das Routing. Sehr lange Tracks werden abgelehnt, teilen Sie diese daher in Abschnitte auf.<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
API-Key in der URL<\/h3>\n\n
Der Key steht immer in der URL, auch bei POST-Anfragen (api_key).<\/p>\n<\/div>\n<\/div>\n\n
\n<\/svg><\/span><\/span>\n\n
\n
Abbiegehinweise in Ihrer Sprache<\/h3>\n\n
Legen Sie die Sprache der Abbiegehinweise fest, wie bei der Routing API (language).<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n
\n
\n
\nAnwendungsf\u00e4lle<\/span>\n\n
Wo Map Matching zum Einsatz kommt.<\/mark><\/h2>\n\n
\u00dcberall dort, wo Menschen oder Fahrzeuge aufzeichnen, wo sie unterwegs waren. Drei typische Beispiele:<\/p>\n<\/div>\n\n
\n\n
Spaziergang am Ufer<\/div>
\"Fitness-App<\/polyline><\/polyline><\/g><\/circle><\/circle><\/svg><\/div><\/div>
5,4 km<\/span>Distanz<\/span><\/span>68 min<\/span>Zeit<\/span><\/span><\/div><\/div><\/div><\/div><\/div><\/div>\n\n
\n
Sport- und Fitness-Apps<\/svg><\/span><\/h3>\n\n
Aufgezeichnete Spazierg\u00e4nge, L\u00e4ufe und Fahrten erscheinen sauber in der Aktivit\u00e4ts\u00fcbersicht, mit der echten Distanz.<\/p>\n<\/div>\n<\/a>\n\n\n
<\/span><\/span><\/span><\/span><\/div>
Flotten\u00fcbersicht<\/span><\/span><\/span><\/span><\/span><\/div>
<\/span>Transporter 1<\/span>7,7 km gefahren<\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div><\/div>
\"Flotten-Dashboard<\/polyline><\/polyline><\/g><\/circle><\/circle><\/svg><\/div><\/div><\/div><\/div><\/div>\n\n
\n
Flotten und Lieferdienste<\/svg><\/span><\/h3>\n\n
Fahrten von Fahrzeugen werden den tats\u00e4chlich befahrenen Stra\u00dfen zugeordnet, f\u00fcr Fahrtenb\u00fccher und Distanzen.<\/p>\n<\/div>\n<\/a>\n\n\n
<\/span><\/span><\/span><\/span><\/div>
Wandertouren<\/span><\/span><\/span><\/span><\/span><\/div>
<\/span>Von der Lucknerh\u00fctte zur St\u00fcdlh\u00fctte<\/span>2,9 km, 624 m Aufstieg<\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div>
<\/span><\/span><\/span><\/span><\/div><\/div>
\"Tourenportal<\/polyline><\/polyline><\/g><\/circle><\/circle><\/svg><\/div><\/div><\/div><\/div><\/div>\n\n
\n
Tourenportale<\/svg><\/span><\/h3>\n\n
Eine mit einem GPS-Ger\u00e4t aufgezeichnete Tour wird zu einer sauberen Route, der Besucher folgen k\u00f6nnen.<\/p>\n<\/div>\n<\/a>\n<\/div>\n\n
\n
Die Routen in diesen Beispielen sind Ergebnisse der Map Matching API.<\/p>\n<\/div>\n<\/div>\n<\/section>\n\n
\n
\n
\n
\nFragen und Antworten<\/span>\n\n
Fragen zum Map Matching.<\/mark><\/h2>\n\n
Kurze Antworten zu Map Matching und Routing, GPX-Dateien, Verkehrsmitteln und Untergr\u00fcnden.<\/p>\n<\/div>\n\n
\n
\n
\n
Was ist der Unterschied zwischen Map Matching und Routing?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Routing beantwortet die Frage nach dem besten Weg von A nach B. Map Matching beantwortet eine andere: Welchen Stra\u00dfen und Wegen ist diese Aufzeichnung tats\u00e4chlich gefolgt? Nutzen Sie die Routing API, um eine Strecke zwischen bekannten Punkten zu planen, und die Map Matching API, um einen bereits aufgezeichneten Track zu bereinigen. Eine gerade berechnete Route abzugleichen, bringt keinen Mehrwert.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
Muss meine GPX-Datei online sein?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Wenn Sie eine GPX-Datei senden, ja. Die API erh\u00e4lt die URL der Datei und l\u00e4dt sie selbst herunter, die Datei muss also \u00f6ffentlich im Internet erreichbar sein. Ein Link hinter einem Login, auf localhost oder in einem privaten Netzwerk funktioniert nicht. Ist Ihr Track nicht online, senden Sie stattdessen die aufgezeichneten Punkte direkt in der Anfrage, in der Reihenfolge ihrer Aufzeichnung.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
F\u00fcr welche Verkehrsmittel kann ich einen Track abgleichen?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Sie k\u00f6nnen eine Aufzeichnung mit dem Wegenetz f\u00fcr Fu\u00dfg\u00e4nger, Radfahrer oder Autos abgleichen. Standard ist zu Fu\u00df. W\u00e4hlen Sie also car, wenn Sie eine Autofahrt abgleichen, und bike f\u00fcr eine Radfahrt. Sonst wird eine Autofahrt mit dem Fu\u00dfwegenetz abgeglichen und kann auf Fu\u00dfwegen landen, die kein Auto befahren k\u00f6nnte.<\/p>\n<\/div>\n<\/div>\n\n
\n
\n
Kann ich herausfinden, auf welchem Untergrund ein aufgezeichneter Track verl\u00e4uft?<\/h3>\n\n\n\n<\/svg><\/span><\/svg><\/span><\/span>\n<\/div>\n\n\n\n
\n
Ja. Nutzen Sie daf\u00fcr die Route Enhancement API. Sie senden den Track als GPX- oder KML-Datei oder als GeoJSON. Die API gleicht den Track selbst mit dem Stra\u00dfennetz ab und liefert f\u00fcr jeden Abschnitt Untergrund und Wegtyp, etwa Asphalt oder unbefestigt. Abschnitte, die sie nicht sicher zuordnen kann, erhalten den Untergrundtyp other. Das bedeutet unbekannt, nicht etwa ein ungew\u00f6hnlicher Untergrund.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n\n