Map Matching API

Saubere Routen aus GPS-Aufzeichnungen.

Smartphones und GPS-Geräte zeichnen Tracks auf, die oft mehrere Meter danebenliegen: sie schneiden Kurven ab, springen zwischen Straßen hin und her oder landen im Fluss. Die Map Matching API legt jede Aufzeichnung zurück auf die Straßen und Wege, auf denen sie entstanden ist.

Vom Smartphone aufgezeichnetNach dem Map Matching
Was Map Matching macht

Von der wackeligen Linie zur Route.

Die API vergleicht die Aufzeichnung mit den Straßen und Wegen in der Umgebung und ermittelt, welche davon tatsächlich genutzt wurden. Drei Dinge ändern sich:

Zurück auf dem Weg

Punkte, die in einen Fluss, ein Gebäude oder die Nachbarstraße abdriften, werden zurück auf den Weg gelegt, der tatsächlich gegangen oder gefahren wurde.

Aufzeichnung5,57 kmAbgeglichen5,39 km

Die echte Distanz

Eine wackelige Aufzeichnung verläuft im Zickzack und fällt länger aus als der Weg selbst. Die abgeglichene Route misst die Straßen und Wege, die tatsächlich genutzt wurden.

Rechts abbiegen in die Herzog-Friedrich-StraßeRechts abbiegen in die HofgasseLeicht links abbiegen in die Pfarrgasse

Abbiegehinweise und Straßennamen

Die saubere Route enthält Abbiegehinweise und Straßennamen, die einer reinen Aufzeichnung fehlen.

Live-Demo

Gleichen Sie Ihre eigene Aufzeichnung ab.

Eine Radtour durch die Grachten von Amsterdam, mit dem Smartphone aufgezeichnet und bereits den richtigen Straßen zugeordnet. Laden Sie Ihren eigenen Track hoch oder zeichnen Sie einen auf der Karte.

Laden Sie eine GPX-, KML- oder GeoJSON-Datei hoch

Oder klicken Sie einen Track in die Karte

Gleichen Sie ihn für Radfahren, Gehen oder Autofahren ab

Für Entwickler

Aufzeichnung senden, Route erhalten.

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.

Der Spaziergang oben auf der Seite
const body = new URLSearchParams({
  gpx: "https://docs.maptoolkit.com/demos/innsbruck-walk.gpx",
  routeType: "foot"
});
const res = await fetch(
  "https://routing.maptoolkit.net/match?api_key=YOUR_API_KEY",
  { method: "POST", body }
);
const route = (await res.json()).paths[0];

Das Ergebnis ist die dunkelblaue Route in den Karten oben: 5,39 km Straßen und Wege.

Eine GPX-Datei oder eine Liste von Punkten

Geben Sie die URL einer GPX-Datei an oder senden Sie die aufgezeichneten Punkte in ihrer Reihenfolge (point).

Dieselbe Antwort wie bei der Routing API

Linie, Distanz, Zeit und Abbiegehinweise, im selben Format wie bei einer berechneten Route.

Lange Aufzeichnungen per POST

Eine echte Aufzeichnung hat Hunderte Punkte, deshalb gehört sie in den Body der Anfrage.

Planen Sie etwas Zeit ein

Der Abgleich dauert länger als das Routing. Sehr lange Tracks werden abgelehnt, teilen Sie diese daher in Abschnitte auf.

API-Key in der URL

Der Key steht immer in der URL, auch bei POST-Anfragen (api_key).

Abbiegehinweise in Ihrer Sprache

Legen Sie die Sprache der Abbiegehinweise fest, wie bei der Routing API (language).

Fragen und Antworten

Fragen zum Map Matching.

Kurze Antworten zu Map Matching und Routing, GPX-Dateien, Verkehrsmitteln und Untergründen.

Was ist der Unterschied zwischen Map Matching und Routing?

Routing beantwortet die Frage nach dem besten Weg von A nach B. Map Matching beantwortet eine andere: Welchen Straßen und Wegen ist diese Aufzeichnung tatsächlich 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.

Muss meine GPX-Datei online sein?

Wenn Sie eine GPX-Datei senden, ja. Die API erhält die URL der Datei und lädt sie selbst herunter, die Datei muss also öffentlich 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.

Für welche Verkehrsmittel kann ich einen Track abgleichen?

Sie können eine Aufzeichnung mit dem Wegenetz für Fußgänger, Radfahrer oder Autos abgleichen. Standard ist zu Fuß. Wählen Sie also car, wenn Sie eine Autofahrt abgleichen, und bike für eine Radfahrt. Sonst wird eine Autofahrt mit dem Fußwegenetz abgeglichen und kann auf Fußwegen landen, die kein Auto befahren könnte.

Kann ich herausfinden, auf welchem Untergrund ein aufgezeichneter Track verläuft?

Ja. Nutzen Sie dafür 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ßennetz ab und liefert für 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öhnlicher Untergrund.

Ihr Anwendungsfall auf einer Maptoolkit-Karte.

In der Demo führt Sie einer unserer Entwickler durch die Plattform, Ihre Daten und den Wechsel von Ihrem bisherigen Anbieter.