API Meteo

Previsione#

Parametri

Risposta

{
  "latitude": 48.85,
  "longitude": 2.35,
  "timezone": "Europe/Paris",
  "grid": {
    "latitude": 48.85, "longitude": 2.35,
    "distance_km": 0.42, "resolution_km": 1.3
  },
  "elevation": {
    "applied": true,
    "model_elevation_m": 91.0,
    "location_elevation_m": 113,
    "temperature_offset_c": -0.14
  },
  "source": {
    "model": "mf_arome",
    "model_run": "20260801T00Z",
    "reference_time": "2026-08-01T00:00:00+00:00",
    "data_age_hours": 3.95,
    "stale": false,
    "attribution": "Data: Météo-France (etalab-2.0)"
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+02:00", "..."],
    "temperature_2m": [18.1, 17.9, 17.6, "..."],
    "apparent_temperature": [17.4, "..."],
    "weather_code": [0, 1, 2, "..."]
  },
  "daily": {
    "date": ["2026-08-01", "..."],
    "temperature_2m_max": [26.6, "..."],
    "temperature_2m_min": [16.2, "..."],
    "precipitation_sum": [0.0, "..."],
    "uv_index_max": [7.6, "..."],
    "sunrise": ["2026-08-01T06:24:00+02:00", "..."],
    "sunset": ["2026-08-01T21:24:00+02:00", "..."],
    "daylight_hours": [15.0, "..."]
  }
}

Alleggerire il payload

Il blocco orario completo su 15 giorni è di circa 32 campi × 360 ore. Se ne rappresenta tre, ne chieda tre:

GET /v1/forecast?lat=48.85&lon=2.35&days=3
    &hourly=temperature_2m,precipitation,weather_code
    &include_daily=false

Stesso prezzo — il costo è leggere l'archivio, non serializzarlo — ma un decimo dei byte e un'analisi nettamente più rapida su un telefono.

Previsione per città#

Preferisca questo alle coordinate grezze quando può. Il catalogo fornisce due cose che una coordinata non può dare: la quota reale della città, così la correzione per il rilievo si applica senza che lei la fornisca, e il suo fuso orario, così gli aggregati giornalieri sono tagliati sulla giornata locale giusta.

GET /v1/forecast/city/dz/alger      # slug francese
GET /v1/forecast/city/dz/algiers    # slug inglese — stessa città
GET /v1/forecast/city/fr/paris

country è un codice ISO-3166-1 alfa-2 in minuscolo. slug è insensibile agli accenti: bejaia trova Béjaïa. Uno slug sconosciuto restituisce 404 city_not_found con un array suggestions — lo mostri anziché un vicolo cieco.

Tutti i parametri di query di /v1/forecast si applicano ancora, tranne lat, lon ed elevation, che il catalogo fornisce. Passare timezone sovrascrive quello della città, il che non è quasi mai ciò che si vuole.

Condizioni attuali#

Temperatura, umidità, vento e pressione sono interpolati linearmente all'istante attuale, tra i due passi del modello che lo racchiudono.

Lo usi per una visualizzazione «in questo momento». Per tutto ciò che confronterà nel tempo, usi /v1/forecast e legga l'ora che le interessa: la serie è stabile, mentre adesso le si muove sotto i piedi tra due chiamate.

Riferimento dei campi#

Campi orari

21 di essi tornano per impostazione predefinita. Gli altri sono a sua disposizione a richiesta — li nomini in hourly=, separati da virgole — e sono trattenuti per una questione di costo, non di affidabilità: ogni campo memorizzato è una lettura compressa distinta, quindi una risposta predefinita che portasse tutti e 45 farebbe pagare ogni chiamante per i pochi che vogliono lo spessore della neve.

GET /v1/forecast?lat=45.19&lon=5.72&hourly=temperature_2m,snow_line_altitude,soil_temperature_8cm

Un campo che un modello non pubblica torna come null per il tratto di previsione di quel modello, anziché sparire dalla risposta — così una catena che comincia su AROME e prosegue su ICON-EU restituisce visibility dall'inizio alla fine, a null per le prime 51 ore. Un nome di campo sconosciuto dà un 400 unknown_field, con la corrispondenza più vicina suggerita; prima veniva ignorato in silenzio.

Campi giornalieri

date, temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, wind_speed_max, wind_gust_max, shortwave_radiation_sum (MJ/m²), uv_index_max, sunrise, sunset, daylight_hours, weather_code.

Aggregati su giornate solari locali, non UTC. Una giornata parziale a un estremo dell'intervallo viene omessa anziché riportata con un massimo fuorviante — quindi una richiesta di 7 giorni può legittimamente restituire 6 righe giornaliere.

Modelli e risoluzione#

Serviamo il modello più fine che copre sia il suo punto sia la sua scadenza. Lei non ne sceglie mai uno; la scelta è riportata in source.model, così può sempre sapere quale ha risposto.

I modelli ad alta risoluzione sono tutti a breve termine — a 1 km l'atmosfera diventa caotica entro due giorni, quindi prevedere oltre non avrebbe senso — e la risoluzione scende perciò a gradini man mano che la previsione avanza:

giorno 0 ──── giorno 2 ──── giorno 5 ─────────────── giorno 15
  AROME 1,3 km (Francia)
  ICON-D2 2,2 km (Germania, Alpi, Benelux)
  HRRR 3 km (USA e Canada meridionale)
              ICON-EU 6,5 km (Europa)
                          ICON 13 km · CEPMMT 28 km (globale)
                                              AIFS (solo tendenza)

Le transizioni al bordo del dominio di un modello sono sfumate, così due località ai due lati di un confine non divergono mai per un salto netto.

/v1/models non richiede chiave, il che ne fa l'endpoint giusto da interrogare da una pagina di stato o prima di acquistare: riporta l'ultima corsa di ogni modello e la sua età, così «i dati sono freschi?» si risponde senza spendere un credito.

Probabilità d'insieme#

Una previsione singola dice 22 °C giovedì. È una congettura presentata come un fatto. Questo endpoint risponde alla domanda su cui lei decide davvero: quanto è sicura, e quale probabilità di pioggia merita di organizzarsi attorno.

È calcolato dall'insieme del CEPMMT — lo stesso modello eseguito 50 volte da condizioni iniziali leggermente diverse. Dove le corse concordano, la previsione è sicura. Dove si disperdono, è l'atmosfera stessa a essere incerta, e nessun modello per quanto buono può dirle di più.

{
  "members": 50,
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "temperature_2m_p10": [26.4],
    "temperature_2m_p50": [26.78],
    "temperature_2m_p90": [27.3],
    "temperature_2m_spread": [0.4],
    "precipitation_probability_0_1mm": [10.0],
    "precipitation_probability_1_0mm": [0.0],
    "precipitation_probability_5_0mm": [0.0],
    "precipitation_probability_10_0mm": [0.0],
    "precipitation_p90": [0.1]
  }
}

Come leggerlo

p10 e p90 racchiudono l'80 % centrale dei membri: uno su dieci si aspetta più freddo di p10, uno su dieci più caldo di p90. Uno spread di 0,4 °C è una situazione consolidata di cui può fidarsi; 3 °C significa che i modelli divergono e conviene dirlo ai suoi utenti anziché sceglierne uno.

Le soglie di pioggia sono decisioni e non cifre tonde — 0,1 mm è bagnato, punto, 1 mm è prenda un cappotto, 5 e 10 mm sono questo è un problema. precipitation_p90 è il caso sfavorevole: solo un membro su dieci è più piovoso.

Qualità dell'aria#

Questo è l'endpoint che conta di più in Nordafrica e nel Mediterraneo. Un episodio di polvere spinge le PM10 oltre i mille microgrammi per metro cubo per giorni interi, il che è una decisione di salute più che una cifra, ed è coperto male dai servizi gratuiti di largo consumo.

{
  "current": {
    "pm2_5": 38.7,
    "band": "poor",
    "who_guidelines_ug_m3": {"pm2_5": 15.0, "pm10": 45.0,
                             "nitrogen_dioxide": 25.0, "ozone": 100.0}
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "pm2_5": [38.7], "pm10": [85.8], "ozone": [43.4],
    "nitrogen_dioxide": [19.0], "dust_aod_550nm": [0.24]
  },
  "units": {"pm2_5": "ug/m3", "pm10": "ug/m3", "dust_aod_550nm": "1"}
}

Tutte le concentrazioni sono in µg/m³, l'unità in cui la qualità dell'aria viene citata ovunque. dust_aod_550nm è uno spessore ottico e non ha unità: sopra circa 0,5 il cielo è visibilmente velato, sopra 1,0 il sole è attenuato.

I valori guida a breve termine dell'OMS viaggiano in ogni risposta, così una cifra può essere collocata senza andarla a cercare. band segue l'indice europeo di qualità dell'aria per il PM2,5: buona, discreta, media, scadente, molto scadente, estremamente scadente.

La neve e il limite delle nevicate#

Quattro campi, e rispondono a domande diverse. snowfall è quanta ne cade; gli altri descrivono ciò che è al suolo, e dove.

Li chieda per nome — non sono nella risposta predefinita:

GET /v1/forecast?lat=45.19&lon=5.72&hourly=snowfall,snow_depth,snow_water_equivalent,snow_line_altitude,freezing_level_altitude

È il limite delle nevicate che vale la pena leggere. «Piove a 800 m e nevica a 1200» è un'informazione su cui una stazione sciistica, un ente stradale o un automobilista possono agire; «3 mm di precipitazione» no. Conta anche in Nordafrica — l'Atlante ha comprensori sciistici a Chréa e Tikjda, e gli altipiani di Sétif, Batna e Djelfa superano i 1000 m.

Questi campi provengono da ICON, del DWD, che copre il mondo a 13 km. I dati aperti del CEPMMT pubblicano lo spessore nevoso ma non il limite delle nevicate: è quindi un caso in cui il modello più grossolano è il più utile. snow_line_altitude è un prodotto regionale — ICON-EU e ICON-D2 lo pubblicano, ICON globale no, quindi fuori dall'Europa ottiene l'isoterma e lo spessore, ma non il limite stesso.

Mare — stato del mare#

{
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "wave_height": [0.32],
    "wave_direction": [264.3],
    "wave_period": [3.79],
    "wave_peak_period": [4.21]
  }
}

L'altezza d'onda è l'altezza significativa — la media del terzo di onde più alte, che è più o meno ciò che riferisce un osservatore in mare. Le onde singole raggiungono circa il doppio, ed è quella la cifra che conta se sta decidendo se uscire. La direzione è quella da cui provengono le onde, come per il vento.

Fiumi#

Risponde a ciò che nessun modello meteorologico può dare: non quanta pioggia cade a monte, ma quanta acqua arriva qui — una cifra del tutto diversa, separata dalla pioggia da un bacino idrografico, da uno stato di umidità del suolo e da uno o due giorni di percorso.

{
  "disclaimer": "Information only. Only national and regional authorities
                 are authorised to issue flood warnings.",
  "daily": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "river_discharge": [4.953],
    "soil_wetness_index": [0.448]
  }
}