Mit dem Routen-Endpunkt von Maps berechnest du Strecke und Fahrzeit zwischen zwei oder mehr Punkten. Das hilft zum Beispiel bei Anfahrtskosten im Angebot, bei Liefergebieten oder bei der Tourenplanung für den Außendienst. Du bekommst Entfernung, Dauer, den Streckenverlauf und die einzelnen Abbiegehinweise.
Die Anfrage
Die Route ist ein GET an https://api.flowdata.one/v1/maps/directions. Pflicht sind Start (origin) und Ziel (destination), jeweils als Längengrad,Breitengrad. Der Längengrad steht also zuerst.
curl "https://api.flowdata.one/v1/maps/directions?origin=13.4050,52.5200&destination=13.7373,51.0504&profile=driving&language=de" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Das Beispiel berechnet eine Autofahrt von Berlin nach Dresden. Koordinaten zu einer Adresse bekommst du per Geocoding, siehe Wie wandle ich eine Adresse in Koordinaten um und umgekehrt?.
Alle Parameter
| Parameter | Bedeutung |
|---|---|
origin |
Startpunkt als Längengrad,Breitengrad, Pflicht. |
destination |
Zielpunkt als Längengrad,Breitengrad, Pflicht. |
waypoints |
Zwischenstopps, mehrere getrennt durch einen senkrechten Strich |, zum Beispiel 12.3731,51.3397|11.5820,50.9271. In einer URL schreibst du ihn als %7C. |
profile |
Verkehrsmittel: driving-traffic (Auto mit aktueller Verkehrslage, Standard), driving (Auto), walking (zu Fuß) oder cycling (Fahrrad). |
alternatives |
1 liefert, wenn möglich, zusätzlich Alternativrouten. Schreib 1, nicht true. |
avoid |
Straßentypen, die gemieden werden sollen, zum Beispiel motorway, toll oder ferry. Mehrere Werte trennst du mit Komma. |
language |
Sprache der Wegbeschreibung. Standard ist de. |
Gibst du kein profile an, rechnet Maps mit driving-traffic, also mit dem Auto unter Berücksichtigung der aktuellen Verkehrslage. Die Abbiegehinweise stehen immer in der Antwort, du musst sie nicht einschalten.
Die Antwort
{
"success": true,
"routes": [
{
"distance": 193412.6,
"duration": 7380.4,
"geometry": {"type": "LineString", "coordinates": [[13.405, 52.52], [13.4061, 52.5183], "..."]},
"legs": [
{
"distance": 193412.6,
"duration": 7380.4,
"summary": "A 13",
"steps": [
{
"distance": 412.3,
"duration": 61.2,
"geometry": {"type": "LineString", "coordinates": ["..."]},
"instruction": "Fahre Richtung Süden auf der Spandauer Straße.",
"maneuver": {"type": "depart", "modifier": null, "location": [13.405, 52.52]}
}
]
}
],
"summary": "",
"weight": 7811.9
}
],
"waypoints": [
{"name": "Spandauer Straße", "location": [13.405, 52.52]},
{"name": "Wilsdruffer Straße", "location": [13.7373, 51.0504]}
],
"attribution": "NOTICE: © 2026 ..."
}
Die Werte im Beispiel sind gekürzt und frei gewählt. So liest du die Felder:
- distance: Strecke in Metern.
193412.6sind also gut 193 Kilometer. - duration: Fahrzeit in Sekunden.
7380.4sind etwa zwei Stunden und drei Minuten. - routes: die Route, mit
alternatives=1auch mehrere. Die erste ist die empfohlene. - legs: ein Abschnitt je Teilstrecke. Ohne Zwischenstopp gibt es einen Abschnitt, mit zwei Zwischenstopps drei.
- steps: die einzelnen Fahranweisungen mit Text in
instructionund dem Manöver. - geometry: der Streckenverlauf als GeoJSON-Linie (
LineString) zum Einzeichnen auf einer Karte. Die Punkte stehen auch hier als[Längengrad, Breitengrad]. - waypoints: Start, Zwischenstopps und Ziel, so wie Maps sie auf das Straßennetz gelegt hat.
Wenn etwas nicht klappt
- HTTP 422 „Invalid parameters“: Start oder Ziel fehlen,
profilehat einen unbekannten Wert oderalternativesist nicht0oder1. Unterdetailssteht das Feld, zum Beispiel{"profile":["Der ausgewählte Wert für profile ist ungültig."]}. - HTTP 404 „No route found for the specified coordinates“: Zwischen den Punkten gibt es keine Route, etwa mit dem Auto über das Meer, oder ein Punkt liegt zu weit von jeder Straße entfernt. Auch ein ungültiger Wert bei
avoidführt zu dieser Meldung. - HTTP 500 mit
{"message":"Server Error"}: Prüfe das Format der Koordinaten. Jeder Punkt braucht genau zwei Zahlen mit Punkt als Dezimaltrennzeichen, getrennt durch ein Komma, und gültige Werte. Ein falsches Format beantwortet Maps derzeit mit einem Serverfehler statt mit einer klaren Meldung. - Route endet an einem völlig falschen Ort: Meist sind Längen- und Breitengrad vertauscht. Mehr dazu in Maps findet nichts oder die falsche Stelle: Was kann ich tun?.
Was kostet eine Route?
Routen werden je 1.000 erfolgreiche Anfragen berechnet und haben einen eigenen Preis, der über dem von Suche und Geocoding liegt. Antworten mit HTTP 404 oder 422 und Serverfehler sind kostenlos. Die Beträge stehen auf der Preisseite, Details in FlowData-Preise verstehen.
Gut zu wissen
- Wiederholst du eine Anfrage mit genau denselben Punkten, Optionen und derselben Sprache, beantwortet Maps sie aus einem Zwischenspeicher. Das ist schneller und wird wie jede erfolgreiche Antwort berechnet, bedeutet bei
driving-trafficaber auch: Die Fahrzeit spiegelt die Verkehrslage zum Zeitpunkt der ersten Berechnung. Für Angebote und Planungen istdrivingdeshalb oft die bessere Wahl. - Die Antwort enthält einen Nutzungshinweis im Feld
attribution. Die Daten dürfen nicht dauerhaft gespeichert werden.