Mehr aus jeder Route.
Senden Sie einen GPX-, KML- oder GeoJSON-Track und erhalten Sie, was Menschen darüber wissen wollen: das Höhenprofil, den Untergrund, die Dauer und die Abbiegehinweise.
Track rein, Details raus.
Hinein geht eine Linie aus Koordinaten, unterwegs aufgezeichnet oder mit wenigen Klicks gezeichnet. Die Antwort ergänzt, was Menschen wissen wollen. Sie kombiniert Routing API, Elevation API und Map Matching API in einer einzigen Anfrage.
Ihr Track
Angereichert
Mit dem Rad von Salzburg nach Hallein entlang der Salzach: eine Linie der Routing API, angereichert durch die Route Enhancement API.
Vier Antworten für jede Route.
Fragen Sie ab, was Sie brauchen. Jede Angabe ist ein einzelner Schalter in der Anfrage:
Höhenprofil
Höhen etwa alle 100 m, dazu die Höhenmeter im Auf- und Abstieg und der höchste Punkt.
Wegtyp und Untergrund
Welche Abschnitte über Straßen, Radwege oder Pfade führen und ob sie asphaltiert, befestigt oder unbefestigt sind.
Reisezeiten
Geschätzte Zeiten zu Fuß und für drei Radtypen, berechnet aus Distanz und Steigungen.
Abbiegehinweise
Jede Abbiegung als kurze Anweisung mit Straßennamen, in der Sprache Ihrer Wahl.
Immer auf Ihrer Strecke.
Manche Routen sollen einer festgelegten Strecke folgen, etwa einer beschilderten Radroute. Die Routing Enhancement API routet von einem beliebigen Start zum nächstgelegenen Punkt Ihrer Strecke, folgt der Strecke und verlässt sie erst wieder nahe am Ziel.
Hier trifft eine Fahrt ab Fuschl am See in St. Gilgen auf die Strecke entlang des Wolfgangsees.
Eine Anfrage pro Track.
Senden Sie den Track als Datei-URL oder als GeoJSON und schalten Sie ein, was Sie brauchen. Die Antwort ist JSON, bereit für Ihre Karte und Ihre Tourenseiten. Verfügbar in den Self-Service-Plänen auf RapidAPI und mit Maptoolkit Enterprise.
const res = await fetch("https://enhance.maptoolkit.net/route?api_key=YOUR_API_KEY", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
kml: "https://maptoolkit.net/export/ts_demo_tours/_1603292819.kml",
elevation: 1, surface: 1, timings: 1, mapmatch: 1, language: "en",
}),
});
const { elevation, surface, timings, mapmatch } = await res.json();Für diese Demo-Tour lautet die Antwort: 9,2 km, 824 m Aufstieg, 3 h 55 min zu Fuß.
GPX, KML oder GeoJSON
Eine Datei-URL (gpx, kml) oder ein LineString bzw. MultiLineString (geometry).
GET oder POST
Kurze Linien passen in die URL, lange Tracks gehören in den Body der Anfrage.
Höhen alle 100 m
Verringern Sie den Abstand auf bis zu 50 m (densifyGap) oder behalten Sie Ihre eigenen Punkte (densify=0).
Wegtyp und Untergrund
Positionen entlang der Route von 0 bis 1; „other“ bedeutet unbekannt. Den Abgleich können Sie feinjustieren (mapMatchingThreshold).
Abbiegehinweise in Ihrer Sprache
Anweisungen für jede Abbiegung, mit Straßennamen (mapmatch, language).
API-Key und Cache
Hängen Sie Ihren Key an jede Anfrage an (api_key). Wiederholte Anfragen werden aus dem Cache beantwortet (cache).
Höhen von Mapterhorn
Die Höhendaten stammen von Mapterhorn: Copernicus mit 30 m weltweit, dazu nationale Modelle wie 1 m für Österreich und Deutschland und 0,5 m für die Schweiz.
Dürfen Sie behalten
Sie dürfen die Ergebnisse speichern und auf Ihren eigenen Seiten zeigen.
Wo angereicherte Routen zum Einsatz kommen.
Überall dort, wo Routen Menschen gezeigt werden, die wissen wollen, was sie erwartet. Drei typische Beispiele:
Tourenportale
Jede Wander- und Radtour mit Profil, Höhenmetern und Gehzeit, ohne Nachmessen von Hand.
Mobile Apps
Zeigen Sie Radfahrern vor dem Start, wie die Strecke beschaffen ist: Straßen, Radwege oder Pfade.
Backend-Integration
Redakteure laden eine GPX-Datei hoch, und die Eckdaten der Tour füllen sich von selbst aus.
Die Routen in diesen Beispielen sind Ergebnisse der Routing API, angereichert durch die Route Enhancement API.
Fragen zur Routenanreicherung.
Kurze Antworten zu aufgezeichneten Höhen, Untergrund und Wegtypen, Fortbewegungsarten und Tracks aus mehreren Teilen.
Übernimmt die API die Höhen, die mein GPS-Gerät aufgezeichnet hat?
Ja. Hat jeder Punkt Ihres Tracks bereits eine Höhe, wie bei den meisten aufgezeichneten GPS-Tracks, erhalten die Punkte, die die API dazwischen ergänzt, Höhen, die aus Ihren aufgezeichneten Werten interpoliert werden. So werden aufgezeichnete und modellierte Höhen nicht vermischt. Nur wenn Höhen fehlen, etwa bei einer mit wenigen Klicks gezeichneten Linie, übernehmen die ergänzten Punkte ihre Höhen aus dem Geländemodell.
Welche Untergründe und Wegtypen kann die API unterscheiden?
Wegtypen sind Autobahnen, Hauptstraßen, Straßen, Ortsstraßen, Fußwege, Radwege, Pfade, Wanderwege und Bergwanderwege. Als Untergrund gibt es Asphalt, befestigt, unbefestigt, naturbelassen und alpin. Jeder Abschnitt der Route erhält je einen Wegtyp und einen Untergrund, zusammen mit seiner Position entlang der Route. So können Sie die Linie nach Untergrund einfärben oder Ihre Touren auf jene filtern, die mit dem Rennrad machbar sind.
Spielt es eine Rolle, ob die Route zu Fuß, mit dem Rad oder mit dem Auto zurückgelegt wird?
Ja. Stellen Sie die Fortbewegungsart auf walking, bike oder car, und die API gleicht Ihren Track mit den Wegen und Straßen ab, die mit dieser Fortbewegungsart nutzbar sind. Die Abbiegehinweise und Wegtypen passen dann dazu, wie Menschen tatsächlich unterwegs sind. Wählen Sie immer die Fortbewegungsart, die zu Ihrer Tour passt, zum Beispiel walking für eine Wandertour und car für eine Panoramafahrt.
Kann ich einen Track senden, der aus mehreren Teilen besteht?
Ja. Senden Sie ihn als GeoJSON-MultiLineString mit einer Linie pro Teil, zum Beispiel für eine Tour mit einer Lücke oder für mehrere getrennte Etappen. Die API hält die Teile auseinander: Wegtypen, Untergründe und Reisezeiten kommen für jeden Teil einzeln zurück, in derselben Reihenfolge, in der Sie die Teile gesendet haben. Wenn Sie Summen für die ganze Tour zeigen, addieren Sie die Ergebnisse aller Teile.
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.