API Vreme · 1,3 km până la 28 km · 15 zile
Cel mai fin model care îți acoperă punctul. Ales la fiecare cerere.
Majoritatea API-urilor meteo rulează peste tot un singur model global. Acesta ține 8 și decide care dintre ele răspunde pentru o coordonată dată la un termen dat — astfel încât un sat alpin să nu primească aceeași celulă de 28 km ca Atlanticul deschis.
Aceiași 120 km de coastă, așa cum îi vede fiecare model 28 km golful a dispărut 1.3 km insula există
Rezoluția nu este un detaliu din fișa tehnică. Ea decide dacă un golf, o vale sau o insulă există în model — iar o celulă care mediază marea și uscatul îți dă temperatura niciuneia.
8 modele, rezolvate automat
Nu alegi niciodată un model. Trimiți o coordonată; API-ul ia cel mai fin care o acoperă, combină la marginile domeniilor ca valoarea să nu sară, și îți spune în răspuns care model a răspuns.
| Model | Rezoluție | Acoperire | Rulări | Termen | Disponibil după |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Franța și vecinii apropiați | 8 ×/zi | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Europa Centrală | 4 ×/zi | 48 h | 2 h |
| NOAA HRRR | 3 km | Statele Unite continentale | 4 ×/zi | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europa, Africa de Nord, Orientul Apropiat | 2 ×/zi | 120 h | 3 h |
| DWD ICON | 13 km | Lume | 2 ×/zi | 180 h | 4 h |
| ECMWF IFS | 28 km | Lume — mereu prezent | 2 ×/zi | 240 h | 7 h |
| ECMWF AIFS | 28 km | Lume, zilele 11–15 | 2 ×/zi | 360 h | 7 h |
| ECMWF wave | 28 km | Doar oceane și mări | 2 ×/zi | 240 h | 7 h |
Marginile domeniilor
Nicio cusătură acolo unde se termină un model
Schimbarea bruscă a modelului la o frontieră face ca două localități vecine să difere fără motiv fizic. Fiecare domeniu poartă o marjă de amestec: lângă margine ponderea modelului fin scade, iar restul trece la următorul. În interiorul domeniului primești modelul fin nediluat.
Termen
Fin la început, global după
AROME se oprește la 51 de ore, iar HRRR la 48. Dincolo, rezolvatorul coboară prin ICON-EU și ICON până la ECMWF, în aceeași cerere. Seria ta de șapte zile este cusută din cel mai bun model la fiecare pas, iar răspunsul înregistrează amestecul.
Ce vine înapoi
45 câmpuri orare — 27 stocate, 18 calculate pe loc. 21 vin implicit; numiți-le pe celelalte în hourly=, sau numiți mai puține și micșorați răspunsul.
Temperatură și umiditate
temperature_2m, maxime și minime zilnice, dewpoint_2m, umiditate relativă, temperatură resimțită, indice de căldură, răcire eoliană, temperatura suprafeței.
Vânt
Componente u/v la 10 m și 100 m pentru energia eoliană, viteză, direcție, punct cardinal, forță Beaufort și wind_gust_10m.
Precipitații
Precipitații totale decumulate pe interval, ninsoare ca echivalent în apă, și un cod OMM precipitation_type care separă ploaia, ninsoarea și ploaia înghețată.
Nori și vizibilitate
Nebulozitate totală plus joasă, medie și înaltă separat — norul jos face ziua cenușie, cirrusul abia estompează soarele. Optimi pentru aviație și visibility pentru ceață.
Radiație și soare
Iradiere de undă scurtă, separată în directă și difuză pentru randamentul fotovoltaic. Elevația și azimutul soarelui, indicator de zi, răsărit și apus, și un indice UV estimat.
Presiune și instabilitate
Presiune la nivelul mării și la suprafață, tendință pe trei ore, cape pentru potențialul convectiv și vaporii de apă integrați pe coloană.
Sol
Temperatura solului la suprafață și în zona radiculară 7–28 cm — cea care contează pentru agricultură — din ICON. soil_temperature_0cm și soil_temperature_8cm.
Zăpadă
Grosime, echivalent în apă, izoterma de zero grade și snow_line_altitude — altitudinea deasupra căreia precipitațiile cad ca zăpadă, ceea ce este o decizie pe care o autoritate rutieră o poate lua.
Sinteză
Un singur weather_code OMM pe pas de timp, ca clientul să deseneze o pictogramă în loc să reimplementeze logica ce transformă șapte câmpuri în „ploaie slabă”.
Două corecții pe care majoritatea API-urilor le sar
Altitudine
Muntele modelului nu este muntele tău
Un model numeric netezește relieful la grila lui. Un sat de fund de vale poate sta cu 400 m sub altitudinea pe care i-o atribuie modelul, iar temperatura brută greșește cu gradientul termic pe acea diferență.
Trimite elevation cu cererea și valoarea este corectată față de orografia proprie a modelului. În zonă de deal asta valorează de regulă 1–3 °C. Răspunsul indică altitudinea modelului, pe a ta și decalajul aplicat — poți să-l verifici sau să-l ignori.
Prospețime
Învechit bate absent, și o spune
Dacă cea mai nouă rulare a noastră e mai veche decât așteptat, primești totuși date, cu "stale": true și data_age_hours în blocul source. O prognoză veche de opt ore e mai utilă utilizatorilor tăi decât o eroare 500.
Ce nu primești niciodată e un număr învechit care arată proaspăt. Decide în codul tău dacă îl arăți, avertizezi sau treci pe altceva.
{
"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)"
}
}Pe aceeași cheie, nu pe încă o factură
Patru lucruri care în altă parte sunt de obicei produse separate. Aici sunt puncte de acces pe planul pe care deja l-ai cumpărat.
/v1/probability
Cât de sigură e prognoza?
O singură valoare spune 22 °C joi — o presupunere prezentată ca fapt. Aceasta returnează p10, p50, p90 și dispersia din ansamblul de 50 de membri al ECMWF, plus probabilitățile de ploaie la 0,1, 1, 5 și 10 mm.
O dispersie de 0,4 °C e o situație așezată. O dispersie de 3 °C înseamnă că însăși atmosfera e incertă, iar utilizatorii tăi merită să afle.
/v1/air-quality
Pulberi, ozon, NO₂ — și praf saharian
De la Copernicus CAMS, cu valorile ghid ale OMS în fiecare răspuns, ca un număr să poată fi așezat fără a fi căutat aiurea.
Praful contează în Africa de Nord și în Mediterana: un episod duce PM10 peste o mie de µg/m³ zile la rând, iar serviciile gratuite pentru public îl acoperă slab.
/v1/marine
Starea mării în toată lumea
Înălțime semnificativă a valului, direcție și perioadă din modelul de valuri ECMWF, până la zece zile. Un punct pe uscat returnează 404 not_at_sea în loc de o coloană de valori nule care arată a defecțiune.
/v1/hydrology
Câtă apă ajunge aici
Debit fluvial de la Copernicus GloFAS pe o rețea de râuri de 0,05° — nu câtă ploaie cade în amonte, ci câtă apă ajunge în acest punct, lucruri pe care le despart un bazin și o zi de parcurs.
Doar informativ. Emiterea avertizărilor de inundație este rezervată autorităților naționale și regionale.
Unde se pune la treabă
Produse meteo
Pagini de oraș, aplicații și widgeturi. Un cod OMM pe pas pentru pictogramă, agregate zilnice tăiate în fusul utilizatorului, și un catalog de orașe cu căutare și cel mai apropiat punct.
Energie
Vânt la 100 m pentru înălțimea butucului, iradiere directă și difuză pentru randamentul fotovoltaic, și dispersie de ansamblu pentru latura de risc a unei poziții.
Agricultură
Temperatura și temperatura solului la patru adâncimi, intrări pentru evapotranspirație, risc de îngheț din temperatura minimă, și rafale pentru ferestrele de stropit.
Logistică și drumuri
Limita zăpezii, izoterma de zero grade, tipul precipitațiilor și vizibilitatea — cele patru câmpuri care decid dacă se închide o trecătoare.
Marin și outdoor
Înălțimea, perioada și direcția valului, rafale, indice UV și lumină de zi, pentru planificarea care trebuie făcută cu o săptămână înainte.
Revânzători
Poți redistribui. Construiește un produs deasupra și vinde-l, cu o linie de atribuire în subsol drept singura obligație care te urmează.
Ce face prost
Preferăm să cunoști limitele acum decât să le descoperi în producție.
Puternic
Temperatură, presiune, vânt sinoptic, umiditate, durata de strălucire a soarelui. Eroarea tipică a temperaturii la 2 m la 24 de ore este în jur de 1–1,5 °C. ECMWF este cel mai bun model determinist global din lume, și asta primești.
Slab
Furtuni convective — o celulă de 28 km nu poate rezolva o furtună, iar nici 3 km nu fac mai mult decât s-o sugereze. Poziția și ora exactă a averselor. Microclimatul de coastă și de munte sub rezoluția modelului. Brizele marine și lacurile de aer rece din văi, pe care corecția de altitudine nu le modelează.
Onestitate geografică
În Franța, Germania, Statele Unite și Canada servim modele naționale la 1,3–3 km și un sat mic chiar primește propria celulă. Teritoriile de peste mări, Alaska, Hawaii și nordul Canadei sunt în afara acestor domenii și revin la 13 km. În restul Europei ai 6,5 km. În Africa, Orientul Mijlociu și mare parte din Asia cel mai bun model public disponibil e la 13–28 km: primești vremea zonei, nu a străzii. Corecția de altitudine îngustează acel decalaj; nu îl închide.
Nu este un serviciu de avertizare
Fără alerte, fără culori de cod, fără instrucțiuni de acțiune. Acelea aparțin autorităților, care pot și să închidă un drum și să evacueze un sat.
Întrebări frecvente
Ce model îmi va servi locația?
Cel mai fin care o acoperă: AROME la 1,3 km în Franța, ICON-D2 la 2,2 km în Europa Centrală, HRRR la 3 km în Statele Unite, ICON-EU la 6,5 km peste Europa și Africa de Nord, ICON la 13 km în lume, și ECMWF IFS la 28 km ca bază mereu prezentă.
Apelează /v1/models pentru registrul curent și domeniul fiecărui model, sau citește source.model în orice răspuns.
Cât de des se actualizează?
Modelele globale de două ori pe zi la 00 și 12 UTC; modelele naționale de înaltă rezoluție de patru ori pe zi la 00, 06, 12 și 18 UTC. Datele devin utilizabile între 90 de minute și 7 ore după ora rulării, în funcție de furnizor — tabelul de mai sus le dă pe fiecare.
Răspunsurile de prognoză sunt puse în cache cinci minute la margine, ceea ce absoarbe traficul repetat al paginilor de oraș fără a servi vreodată o rulare în urma celei pe care o avem.
Pot cere mai multe locații deodată?
O coordonată pe cerere. Stocarea e împărțită în blocuri astfel încât toată seria temporală a unei zone mici să încapă într-un bloc — un punct pe toți pașii e interogarea ieftină, și e cea pe care practic orice produs o face.
Pentru trafic în formă de oraș, /v1/forecast/city/{country}/{slug} poartă fusul orar și altitudinea orașului, ca să nu trebuiască tu.
Există descărcare în masă?
Nu, pe niciun plan. Arhiva e ceea ce plătești, iar un export fără limită e felul în care un concurent o obține într-o după-amiază. Exportul CSV de grade-zile există și e limitat în mod deliberat.
Cât costă?
Gratuit pentru 10.000 de credite pe lună, fără card. 19 € pe lună pentru 50.000 de credite, inclusiv API-ul Grade-zile, istoric și CSV. 79 € pentru 400.000 de credite și tot restul. O cerere de prognoză valorează un credit.
Încearcă-l pe coordonatele tale
Nivelul gratuit returnează aceleași date ca cele plătite. Îndreaptă-l spre un loc pe care îl cunoști bine și judecă singur cifrele.