Die Anfrage
- route
- Ein GeoJSON-LineString oder -MultiLineString, bis zu 20.000 km und 200.000 Punkte
- departure
- Wann Sie losfahren, mit Offset; jetzt, wenn weggelassen
- speedKmh
- Durchschnittsgeschwindigkeit, 2 bis 80, Standard 20
- stepKm
- Abstand zwischen den Prognosepunkten, 0,5 bis 100; standardmäßig alle 5 km oder ein Hundertstel der Route, höchstens 200 Punkte
Die Antwort
{
"routeLengthKm": 64.5, "speedKmh": 20,
"departure": "2026-11-07T17:51:52.698Z", "arrival": "2026-11-07T21:05:19.533Z",
"summary": { "minTemperatureC": -1.6, "maxTemperatureC": 7.8, "maxPrecipitationMm": 0,
"maxHeadwindKmh": 3.2, "maxGustKmh": 34.1 },
"points": [
{ "km": 0, "lon": 6.143, "lat": 46.204, "time": "2026-11-07T17:51:52.698Z",
"temperatureC": 7.8, "feelsLikeC": 6.1, "precipitationMm": 0, "weatherCode": 2,
"windKmh": 4.9, "windDirDeg": 197, "gustKmh": 9.4, "cloudPct": 52, "humidityPct": 88,
"isDay": false, "headwindKmh": 1.7, "crosswindKmh": 4.6 },
...
]
}headwindKmh ist der Teil des Winds gegen Sie, negativ, wenn er von hinten kommt; crosswindKmh ist der Teil von der Seite. Die Zusammenfassung nennt den kältesten und den wärmsten Moment, die nasseste Stunde sowie den stärksten Gegenwind und die stärkste Böe, sodass ein Client warnen kann, bevor der Nutzer in die Details schaut. Die Prognosen reichen 14 Tage voraus.
Alles zur Route in einer Anfrage
POST /v1/route/report nimmt dieselbe Route entgegen und liefert beliebige dieser Teile zusammen: das Höhenprofil mit Gesamtanstieg, das Wetter zu den Ankunftszeiten, die durchquerten Zeitzonen, Luftmessstationen in der Nähe der Route, Flusspegel und das, was die Route durchquert, etwa Schutzgebiete und Grenzen. Jeder Teil zählt als eine Anfrage, sodass Sie zahlen, was Sie abfragen.
{ "route": { ... }, "include": ["profile", "weather", "timezones"], "departure": "2026-11-08T08:00:00+01:00", "speedKmh": 20 }Profil, Wetter, Zeitzonen, Flüsse und Ebenen für eine 90-km-Fahrt kamen in etwa 6,5 Sekunden zurück.
Wer sie nutzt
Apps für Radfahren, Laufen, Wandern und Touren: ein Tourenplaner, der zeigt, wo der Regen beginnt, eine Trainings-App, die die Richtung einer Runde nach dem Wind wählt, ein Reisetool, das vor Frost auf einem Pass warnt. Die Seite zur Wetter-API behandelt Prognosen für einen Punkt und über ein Gebiet; das Routing kann die Route vorher zeichnen.
Quellenangabe: Wetterdaten von Open-Meteo.com (CC BY 4.0), basierend auf Vorhersagen von ECMWF, NOAA, Deutscher Wetterdienst und Environment and Climate Change Canada.