API Pogody · od 1,3 km do 28 km · 15 dni
Najdrobniejszy model pokrywający twój punkt. Wybierany przy każdym zapytaniu.
Większość API pogodowych uruchamia wszędzie jeden model globalny. To trzyma dziewięć i rozstrzyga, który odpowiada dla danej współrzędnej na danym wyprzedzeniu — tak, by alpejska wieś nie dostała tej samej komórki 28 km co otwarty Atlantyk.
Te same 120 km wybrzeża, tak jak widzi je każdy model 28 km zatoki nie ma 1.3 km wyspa istnieje
Rozdzielczość nie jest szczegółem ze specyfikacji. Decyduje, czy zatoka, dolina albo wyspa w ogóle istnieją w modelu — a komórka uśredniająca morze i ląd daje ci temperaturę żadnego z nich.
8 modeli, rozstrzyganych automatycznie
Nigdy nie wybierasz modelu. Wysyłasz współrzędną; API bierze najdrobniejszy, który ją pokrywa, łączy na krawędziach domen, żeby wartość nie skakała, i mówi w odpowiedzi, który model odpowiedział.
| Model | Rozdzielczość | Zasięg | Przebiegi | Horyzont | Dostępne po |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Francja i najbliżsi sąsiedzi | 8 ×/dzień | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Europa Środkowa | 4 ×/dzień | 48 h | 2 h |
| NOAA HRRR | 3 km | Kontynentalne Stany Zjednoczone | 4 ×/dzień | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europa, Afryka Północna, Bliski Wschód | 2 ×/dzień | 120 h | 3 h |
| DWD ICON | 13 km | Świat | 2 ×/dzień | 180 h | 4 h |
| ECMWF IFS | 28 km | Świat — zawsze obecny | 2 ×/dzień | 240 h | 7 h |
| ECMWF AIFS | 28 km | Świat, dni 11–15 | 2 ×/dzień | 360 h | 7 h |
| ECMWF wave | 28 km | Tylko oceany i morza | 2 ×/dzień | 240 h | 7 h |
Krawędzie domen
Żadnego szwu tam, gdzie kończy się model
Nagła zmiana modelu na granicy sprawia, że dwie sąsiednie miejscowości rozjeżdżają się bez fizycznego powodu. Każda domena ma margines mieszania: przy krawędzi waga modelu drobnego maleje, a reszta przechodzi na następny. Wewnątrz domeny dostajesz model drobny bez domieszek.
Wyprzedzenie
Drobno na początku, globalnie później
AROME kończy się na 51 godzinach, a HRRR na 48. Dalej rozstrzygacz schodzi przez ICON-EU i ICON do ECMWF, w tym samym zapytaniu. Twój siedmiodniowy szereg jest zszyty z najlepszego modelu na każdym kroku, a odpowiedź zapisuje ten miks.
Co wraca
45 pól godzinowych — 27 przechowywanych, 18 liczonych w locie. 21 wracają domyślnie; pozostałe wskazaż w hourly= albo wskazaż mniej i zmniejsz odpowiedź.
Temperatura i wilgotność
temperature_2m, maksima i minima dobowe, dewpoint_2m, wilgotność względna, temperatura odczuwalna, indeks ciepła, wychłodzenie wiatrem, temperatura powierzchni.
Wiatr
Składowe u/v na 10 m i 100 m dla rynku wiatrowego, prędkość, kierunek, róża wiatrów, siła Beauforta i wind_gust_10m.
Opad
Opad całkowity zdekumulowany na interwał, śnieg jako ekwiwalent wodny i kod WMO precipitation_type, który rozdziela deszcz, śnieg i marznący deszcz.
Zachmurzenie i widzialność
Zachmurzenie całkowite plus niskie, średnie i wysokie osobno — to niskie sprawia, że dzień jest szary, cirrus ledwie przygasza słońce. Oktanty dla lotnictwa i visibility dla mgły.
Promieniowanie i słońce
Napromieniowanie krótkofalowe, rozdzielone na bezpośrednie i rozproszone dla uzysku fotowoltaicznego. Wysokość i azymut słońca, znacznik dnia, wschód i zachód oraz szacowany indeks UV.
Ciśnienie i chwiejność
Ciśnienie na poziomie morza i przy powierzchni, tendencja trzygodzinna, cape dla potencjału konwekcyjnego i całkowita para wodna w kolumnie.
Gleba
Temperatura gleby przy powierzchni i w strefie korzeniowej 7–28 cm — tej, która liczy się w rolnictwie — z ICON. soil_temperature_0cm i soil_temperature_8cm.
Śnieg
Grubość, ekwiwalent wodny, izoterma zera i snow_line_altitude — wysokość, powyżej której opad pada jako śnieg, czyli decyzja, na którą zarządca drogi może zareagować.
Podsumowanie
Jeden kod WMO weather_code na krok czasowy, żeby klient rysował ikonę zamiast odtwarzać logikę zamieniającą siedem pól w „słaby deszcz”.
Dwie korekty, które większość API pomija
Wysokość
Góra modelu to nie twoja góra
Model numeryczny wygładza rzeźbę do swojej siatki. Wieś na dnie doliny może leżeć 400 m poniżej wysokości, którą przypisuje jej model, a surowa temperatura myli się o gradient termiczny na tej różnicy.
Wyślij elevation razem z zapytaniem, a wartość zostanie skorygowana względem orografii samego modelu. W terenie górzystym to zwykle 1–3 °C. Odpowiedź podaje wysokość modelu, twoją i zastosowane przesunięcie — możesz je sprawdzić albo zignorować.
Świeżość
Przeterminowane bije brak, i samo to mówi
Jeśli nasz najnowszy przebieg jest starszy niż oczekiwano, nadal dostajesz dane, z "stale": true i data_age_hours w bloku source. Prognoza sprzed ośmiu godzin jest dla twoich użytkowników bardziej użyteczna niż błąd 500.
Czego nigdy nie dostaniesz, to przeterminowanej liczby wyglądającej na świeżą. Zdecyduj we własnym kodzie, czy ją pokazać, ostrzec, czy sięgnąć gdzie indziej.
{
"grid": { "distance_km": 8.04, "resolution_km": 28.0 },
"elevation": {
"applied": true,
"model_elevation_m": 91.0,
"location_elevation_m": 113,
"temperature_offset_c": -0.14
},
"source": {
"model": "ecmwf_ifs",
"model_run": "20260725T00Z",
"data_age_hours": 8.95,
"stale": false,
"attribution": "Data: ECMWF (CC-BY-4.0)"
}
}Na tym samym kluczu, nie na kolejnej fakturze
Cztery rzeczy, które gdzie indziej bywają osobnymi produktami. Tu są punktami końcowymi planu, który już kupiłeś.
/v1/probability
Jak pewna jest prognoza?
Pojedyncza wartość mówi 22 °C w czwartek — przypuszczenie podane jako fakt. To zwraca p10, p50, p90 i rozrzut z 50-członowego zespołu ECMWF oraz prawdopodobieństwa opadu przy 0,1, 1, 5 i 10 mm.
Rozrzut 0,4 °C to sytuacja ustabilizowana. Rozrzut 3 °C oznacza, że niepewna jest sama atmosfera, a twoi użytkownicy zasługują, by im to powiedzieć.
/v1/air-quality
Pyły, ozon, NO₂ — i pył saharyjski
Z Copernicus CAMS, z wartościami wytycznych WHO w każdej odpowiedzi, żeby dało się umiejscowić liczbę bez szukania jej gdzie indziej.
Pył ma znaczenie w Afryce Północnej i nad Morzem Śródziemnym: epizod wynosi PM10 ponad tysiąc µg/m³ na wiele dni, a darmowe serwisy konsumenckie pokrywają to słabo.
/v1/marine
Stan morza na całym świecie
Znacząca wysokość fali, kierunek i okres z modelu falowego ECMWF, do dziesięciu dni. Punkt na lądzie zwraca 404 not_at_sea zamiast kolumny wartości pustych, która wygląda jak awaria.
/v1/hydrology
Ile wody tu dociera
Przepływ rzek z Copernicus GloFAS na sieci rzecznej 0,05° — nie ile deszczu spadło w górze zlewni, ale ile wody dociera do tego punktu, co dzieli zlewnia i dzień drogi.
Tylko informacyjnie. Wydawanie ostrzeżeń powodziowych jest zastrzeżone dla władz krajowych i regionalnych.
Gdzie idzie do pracy
Produkty pogodowe
Strony miast, aplikacje i widżety. Jeden kod WMO na krok dla ikony, agregaty dobowe cięte w strefie użytkownika i katalog miast z wyszukiwaniem oraz najbliższym punktem.
Energetyka
Wiatr na 100 m dla wysokości piasty, promieniowanie bezpośrednie i rozproszone dla uzysku PV oraz rozrzut zespołowy dla strony ryzyka pozycji.
Rolnictwo
Temperatura i temperatura gleby na czterech głębokościach, dane wejściowe do ewapotranspiracji, ryzyko przymrozku z temperatury minimalnej i porywy dla okien oprysku.
Logistyka i drogi
Granica śniegu, izoterma zera, typ opadu i widzialność — cztery pola, które decydują, czy przełęcz zostanie zamknięta.
Morze i outdoor
Wysokość, okres i kierunek fali, porywy wiatru, indeks UV i długość dnia dla planowania, które musi się odbyć z tygodniowym wyprzedzeniem.
Odsprzedawcy
Wolno ci redystrybuować. Zbuduj na tym produkt i sprzedaj go, z jedną linijką atrybucji w stopce jako jedynym obowiązkiem, który za tobą idzie.
Co robi źle
Wolimy, żebyś znał ograniczenia teraz, niż żebyś odkrył je na produkcji.
Mocne strony
Temperatura, ciśnienie, wiatr synoptyczny, wilgotność, usłonecznienie. Typowy błąd temperatury na 2 m po 24 godzinach to około 1–1,5 °C. ECMWF jest najlepszym globalnym modelem deterministycznym na świecie i to go dostajesz.
Słabe strony
Burze konwekcyjne — komórka 28 km nie rozdzieli burzy, a nawet 3 km tylko ją zasugeruje. Dokładne miejsce i czas przelotnych opadów. Mikroklimat nadmorski i górski poniżej rozdzielczości modelu. Bryzy morskie i zastoiska zimnego powietrza w dolinach, których korekta wysokości nie modeluje.
Uczciwość geograficzna
We Francji, Niemczech, Stanach Zjednoczonych i Kanadzie podajemy modele krajowe 1,3–3 km i mała wieś naprawdę dostaje własną komórkę. Terytoria zamorskie, Alaska, Hawaje i północna Kanada leżą poza tymi domenami i wracają do 13 km. W pozostałej Europie masz 6,5 km. W Afryce, na Bliskim Wschodzie i w większości Azji najlepszym dostępnym modelem publicznym jest 13–28 km: dostajesz pogodę okolicy, a nie ulicy. Korekta wysokości zmniejsza tę lukę; nie zamyka jej.
To nie jest służba ostrzegawcza
Żadnych alarmów, żadnych kolorów stopni, żadnych zaleceń działania. To należy do władz, które mogą też zamknąć drogę i ewakuować wieś.
Częste pytania
Który model obsłuży moją lokalizację?
Najdrobniejszy, który ją pokrywa: AROME 1,3 km we Francji, ICON-D2 2,2 km w Europie Środkowej, HRRR 3 km w Stanach Zjednoczonych, ICON-EU 6,5 km nad Europą i Afryką Północną, ICON 13 km na świecie oraz ECMWF IFS 28 km jako zawsze obecna podstawa.
Wywołaj /v1/models, żeby zobaczyć bieżący rejestr i domenę każdego modelu, albo przeczytaj source.model w dowolnej odpowiedzi.
Jak często jest aktualizowane?
Modele globalne dwa razy dziennie o 00 i 12 UTC; krajowe modele wysokorozdzielcze cztery razy dziennie o 00, 06, 12 i 18 UTC. Dane stają się użyteczne między 90 minutami a 7 godzinami po czasie przebiegu, zależnie od dostawcy — tabela powyżej podaje każdy z osobna.
Odpowiedzi prognoz są buforowane pięć minut na brzegu, co wchłania powtarzalny ruch stron miast, nigdy nie podając przebiegu starszego niż ten, który mamy.
Czy mogę zapytać o wiele lokalizacji naraz?
Jedna współrzędna na zapytanie. Magazyn jest podzielony na bloki tak, by cały szereg czasowy małego obszaru mieścił się w jednym bloku — jeden punkt przez wszystkie kroki to zapytanie tanie i to właśnie je wykonuje praktycznie każdy produkt.
Dla ruchu w kształcie miasta /v1/forecast/city/{country}/{slug} niesie strefę czasową i wysokość miasta, żebyś nie musiał tego robić sam.
Czy jest pobieranie masowe?
Nie, w żadnym planie. Archiwum jest tym, za co płacisz, a nieograniczony eksport to sposób, w jaki konkurent zdobywa je w jedno popołudnie. Eksport CSV stopniodni istnieje i jest celowo ograniczony.
Ile to kosztuje?
Za darmo 10000 kredytów miesięcznie, bez karty. 19 € miesięcznie za 50 000 kredytów wraz z API Stopniodni, historią i CSV. 79 € za 400 000 kredytów i całą resztę. Zapytanie o prognozę to jeden kredyt.
Sprawdź je na własnych współrzędnych
Darmowy poziom zwraca te same dane co płatne. Wskaż mu miejsce, które dobrze znasz, i oceń liczby sam.