Żądanie
- route
- GeoJSON LineString lub MultiLineString, do 20 000 km i 200 000 punktów
- departure
- Kiedy wyjeżdżasz, z przesunięciem strefy; domyślnie teraz
- speedKmh
- Średnia prędkość, od 2 do 80, domyślnie 20
- stepKm
- Odległość między punktami prognozy, od 0,5 do 100; domyślnie co 5 km lub setna część trasy, najwyżej 200 punktów
Odpowiedź
{
"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 to część wiatru wiejąca w twarz, ujemna, gdy wieje w plecy; crosswindKmh to część z boku. Podsumowanie podaje najzimniejszy i najcieplejszy moment, najbardziej deszczową godzinę oraz najsilniejszy wiatr czołowy i porywy, więc klient może ostrzec, zanim użytkownik zajrzy w szczegóły. Prognozy sięgają 14 dni w przód.
Wszystko o trasie w jednym żądaniu
POST /v1/route/report przyjmuje tę samą trasę i zwraca dowolne z tych części razem: profil wysokościowy z sumą podejść, pogodę na godziny przyjazdu, przecinane strefy czasowe, stacje jakości powietrza w pobliżu trasy, wodowskazy rzek i to, przez co trasa przebiega, na przykład obszary chronione i granice. Każda część liczy się jako jedno żądanie, więc płacisz za to, o co pytasz.
{ "route": { ... }, "include": ["profile", "weather", "timezones"], "departure": "2026-11-08T08:00:00+01:00", "speedKmh": 20 }Profil, pogoda, strefy czasowe, rzeki i warstwy dla 90-kilometrowego przejazdu wróciły w około 6,5 sekundy.
Kto z tego korzysta
Aplikacje do jazdy na rowerze, biegania, wędrówek i podróży: planer przejazdów pokazujący, gdzie zacznie padać, aplikacja treningowa wybierająca kierunek pętli według wiatru, narzędzie podróżnicze ostrzegające przed mrozem na przełęczy. Strona API pogody opisuje prognozy dla punktu i dla obszaru; routing może najpierw narysować trasę.
Źródła: dane pogodowe z Open-Meteo.com (CC BY 4.0), oparte na prognozach ECMWF, NOAA, Deutscher Wetterdienst i Environment and Climate Change Canada.