API Meteo · da 1,3 km a 28 km · 15 giorni
Il modello più fine che copre il tuo punto. Scelto a ogni richiesta.
La maggior parte delle API meteo fa girare un solo modello globale ovunque. Questa ne tiene 8 e stabilisce quale risponde a una certa coordinata a una certa scadenza — così un paese alpino non riceve la stessa cella da 28 km dell'Atlantico aperto.
Gli stessi 120 km di costa, come li vede ogni modello 28 km la baia è sparita 1.3 km l'isola esiste
La risoluzione non è un dettaglio di scheda tecnica. Decide se una baia, una valle o un'isola esistano nel modello — e una cella che media mare e terra ti dà la temperatura di nessuno dei due.
8 modelli, risolti automaticamente
Non scegli mai un modello. Mandi una coordinata; l'API prende il più fine che la copre, mescola ai bordi di dominio perché il valore non salti, e ti dice nella risposta quale modello ha risposto.
| Modello | Risoluzione | Copertura | Corse | Scadenza | Disponibile dopo |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Francia e dintorni | 8 ×/giorno | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Europa centrale | 4 ×/giorno | 48 h | 2 h |
| NOAA HRRR | 3 km | Stati Uniti continentali | 4 ×/giorno | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europa, Nord Africa, Vicino Oriente | 2 ×/giorno | 120 h | 3 h |
| DWD ICON | 13 km | Mondo | 2 ×/giorno | 180 h | 4 h |
| ECMWF IFS | 28 km | Mondo — sempre presente | 2 ×/giorno | 240 h | 7 h |
| ECMWF AIFS | 28 km | Mondo, giorni 11–15 | 2 ×/giorno | 360 h | 7 h |
| ECMWF wave | 28 km | Solo oceani e mari | 2 ×/giorno | 240 h | 7 h |
Bordi di dominio
Nessuna cucitura dove un modello finisce
Cambiare modello di colpo a un confine fa divergere due paesi vicini senza ragione fisica. Ogni dominio porta un margine di mescolamento: vicino al bordo il peso del modello fine decade e il resto passa al successivo. All'interno del dominio hai il modello fine puro.
Scadenza
Fine all'inizio, globale dopo
AROME si ferma a 51 ore e HRRR a 48. Oltre, il risolutore ripiega attraverso ICON-EU e ICON fino a ECMWF, nella stessa richiesta. La tua serie a sette giorni è cucita con il modello migliore a ogni passo, e la risposta registra il mix.
Cosa torna indietro
45 campi orari — 27 memorizzati, 18 calcolati al volo. 21 tornano per impostazione predefinita; indica gli altri in hourly=, o indicane meno e alleggerisci la risposta.
Temperatura e umidità
temperature_2m, massime e minime giornaliere, dewpoint_2m, umidità relativa, temperatura percepita, indice di calore, wind chill, temperatura superficiale.
Vento
Componenti u/v a 10 m e 100 m per l'eolico, velocità, direzione, punto cardinale, forza Beaufort e wind_gust_10m.
Precipitazione
Precipitazione totale decumulata per intervallo, neve come equivalente in acqua, e un codice OMM precipitation_type che separa pioggia, neve e pioggia gelata.
Nuvolosità e visibilità
Copertura totale più bassa, media e alta separatamente — la nube bassa è ciò che rende grigia una giornata, il cirro attenua appena il sole. Okta per l'aviazione e visibility per la nebbia.
Radiazione e sole
Irradianza a onda corta, separata in diretta e diffusa per la resa fotovoltaica. Elevazione e azimut del sole, indicatore di giorno, alba e tramonto, e un indice UV stimato.
Pressione e instabilità
Pressione al livello del mare e al suolo, tendenza su tre ore, cape per il potenziale convettivo e vapore acqueo integrato sulla colonna.
Suolo
Temperatura del suolo in superficie e nella zona radicale 7–28 cm — quella che interessa all'agricoltura — da ICON. soil_temperature_0cm e soil_temperature_8cm.
Neve
Spessore, equivalente in acqua, quota dello zero termico e snow_line_altitude — la quota sopra la quale la precipitazione cade come neve, che è una decisione su cui un ente stradale può agire.
Sintesi
Un solo weather_code OMM per passo temporale, così il client disegna un'icona invece di reimplementare la logica che trasforma sette campi in «pioggia debole».
Due correzioni che la maggior parte delle API salta
Altitudine
La montagna del modello non è la tua montagna
Un modello numerico liscia il rilievo alla sua maglia. Un paese di fondovalle può stare 400 m sotto la quota che il modello gli attribuisce, e la temperatura grezza sbaglia del gradiente termico su quella differenza.
Manda elevation con la richiesta e il valore viene corretto contro l'orografia del modello stesso. In collina vale tipicamente 1–3 °C. La risposta riporta la quota del modello, la tua e lo scarto applicato — puoi verificarlo, o ignorarlo.
Freschezza
Vecchio batte assente, e lo dichiara
Se la nostra corsa più recente è più vecchia del previsto, ricevi comunque i dati, con "stale": true e data_age_hours nel blocco source. Una previsione di otto ore è più utile ai tuoi utenti di un errore 500.
Quello che non ottieni mai è un numero vecchio che sembra fresco. Decidi nel tuo codice se mostrarlo, avvisare o ripiegare.
{
"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)"
}
}Sulla stessa chiave, non su un'altra fattura
Quattro cose che altrove sono di solito prodotti separati. Qui sono endpoint del piano che hai già comprato.
/v1/probability
Quanto è sicura la previsione?
Un valore singolo dice 22 °C giovedì — una supposizione presentata come un fatto. Questo restituisce p10, p50, p90 e la dispersione dell'insieme a 50 membri di ECMWF, più le probabilità di pioggia a 0,1, 1, 5 e 10 mm.
Una dispersione di 0,4 °C è una situazione assestata. Una dispersione di 3 °C significa che è l'atmosfera stessa a essere incerta, e i tuoi utenti meritano di saperlo.
/v1/air-quality
Polveri, ozono, NO₂ — e sabbia sahariana
Da Copernicus CAMS, con i valori guida dell'OMS in ogni risposta, così un numero si può collocare senza andarlo a cercare.
La polvere conta in Nord Africa e nel Mediterraneo: un episodio porta il PM10 oltre mille µg/m³ per giorni, e i servizi gratuiti al consumatore lo coprono male.
/v1/marine
Stato del mare in tutto il mondo
Altezza significativa dell'onda, direzione e periodo dal modello d'onda ECMWF, fino a dieci giorni. Un punto a terra restituisce 404 not_at_sea invece di una colonna di valori nulli che sembra un guasto.
/v1/hydrology
Quanta acqua arriva qui
Portata dei fiumi da Copernicus GloFAS su una rete idrografica a 0,05° — non quanta pioggia cade a monte, ma quanta acqua raggiunge questo punto, che un bacino e un giorno di percorrenza separano.
Solo informativo. Emettere allerte di piena è riservato alle autorità nazionali e regionali.
Dove va a lavorare
Prodotti meteo
Pagine città, app e widget. Un codice OMM per passo per l'icona, aggregati giornalieri tagliati nel fuso dell'utente, e un catalogo di città con ricerca e punto più vicino.
Energia
Vento a 100 m per l'altezza del mozzo, irradianza diretta e diffusa per la resa fotovoltaica, e dispersione d'insieme per il lato rischio di una posizione.
Agricoltura
Temperatura e temperatura del suolo a quattro profondità, ingressi per l'evapotraspirazione, rischio gelo dalla temperatura minima e raffiche per le finestre di trattamento.
Logistica e strade
Quota neve, zero termico, tipo di precipitazione e visibilità — i quattro campi che decidono se un valico chiude.
Mare e outdoor
Altezza, periodo e direzione dell'onda, raffiche, indice UV e ore di luce per la pianificazione che va fatta con una settimana d'anticipo.
Rivenditori
Puoi redistribuire. Costruisci un prodotto sopra e vendilo, con una riga di attribuzione a piè di pagina come unico obbligo che ti segue.
Cosa fa male
Preferiamo che tu conosca i limiti adesso, invece di trovarli in produzione.
Punti forti
Temperatura, pressione, vento sinottico, umidità, soleggiamento. L'errore tipico della temperatura a 2 m a 24 ore è intorno a 1–1,5 °C. ECMWF è il miglior modello deterministico globale al mondo, ed è quello che ricevi.
Punti deboli
Temporali convettivi — una cella da 28 km non può risolvere un temporale, e nemmeno 3 km fanno più che accennarlo. Posizione e orario esatti dei rovesci. Microclima costiero e di montagna sotto la risoluzione del modello. Brezze di mare e laghi d'aria fredda in valle, che la correzione altimetrica non modella.
Onestà geografica
In Francia, Germania, Stati Uniti e Canada serviamo modelli nazionali a 1,3–3 km e un piccolo paese ha davvero la sua cella. I territori d'oltremare, l'Alaska, le Hawaii e il nord del Canada sono fuori da questi domini e ricadono a 13 km. Altrove in Europa hai 6,5 km. In Africa, Medio Oriente e gran parte dell'Asia il miglior modello pubblico disponibile è a 13–28 km: hai il meteo della zona più che quello della via. La correzione altimetrica riduce quel divario; non lo chiude.
Non è un servizio di allerta
Nessuna allerta, nessun colore di livello, nessuna istruzione ad agire. Questo spetta alle autorità, che possono anche chiudere una strada ed evacuare un paese.
Domande frequenti
Quale modello servirà la mia località?
Il più fine che la copre: AROME a 1,3 km in Francia, ICON-D2 a 2,2 km in Europa centrale, HRRR a 3 km negli Stati Uniti, ICON-EU a 6,5 km su Europa e Nord Africa, ICON a 13 km nel mondo, e ECMWF IFS a 28 km come base sempre presente.
Chiama /v1/models per vedere il registro corrente e il dominio di ogni modello, oppure leggi source.model in qualunque risposta.
Ogni quanto viene aggiornata?
I modelli globali due volte al giorno alle 00 e 12 UTC; i modelli nazionali ad alta risoluzione quattro volte al giorno alle 00, 06, 12 e 18 UTC. I dati diventano utilizzabili tra 90 minuti e 7 ore dopo l'ora della corsa a seconda del fornitore — la tabella sopra li elenca uno per uno.
Le risposte di previsione sono in cache cinque minuti al bordo, il che assorbe il traffico ripetuto delle pagine città senza mai servire una corsa più vecchia di quella che abbiamo.
Posso chiedere molte località in una volta?
Una coordinata per richiesta. L'archiviazione è divisa in blocchi in modo che l'intera serie temporale di una piccola area stia in un blocco — un punto su tutti i passi è la query economica, ed è quella che praticamente ogni prodotto fa davvero.
Per traffico a forma di città, /v1/forecast/city/{country}/{slug} porta il fuso orario e l'altitudine della città, così non devi farlo tu.
C'è un download massivo?
No, su nessun piano. L'archivio è ciò per cui stai pagando, e un'esportazione senza limiti è il modo in cui un concorrente se lo procura in un pomeriggio. L'esportazione CSV dei gradi giorno esiste ed è deliberatamente limitata.
Quanto costa?
Gratis per 10.000 crediti al mese senza carta. 19 € al mese per 50.000 crediti inclusa l'API Gradi Giorno, storico e CSV. 79 € per 400.000 crediti e tutto il resto. Una richiesta di previsione vale un credito.
Provala sulle tue coordinate
Il piano gratuito restituisce gli stessi dati di quelli a pagamento. Puntala su un posto che conosci bene e giudica i numeri da te.