API Meteo

Prognoză#

Parametri

Răspuns

{
  "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, "..."]
  }
}

Micșorarea răspunsului

Blocul orar complet pentru 15 zile înseamnă circa 32 de câmpuri × 360 de ore. Dacă desenați trei dintre ele, cereți trei:

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

Același preț — costul stă în citirea arhivei, nu în serializare — dar a zecea parte din octeți și vizibil mai rapid de parsat pe telefon.

Prognoză pe oraș#

Preferați asta coordonatelor brute oriunde puteți. Catalogul oferă două lucruri pe care o coordonată nu le poate oferi: altitudinea adevărată a orașului, astfel încât corecția de relief se aplică fără să o dați dumneavoastră, și fusul lui orar, astfel încât agregatele zilnice sunt tăiate pe ziua locală corectă.

GET /v1/forecast/city/dz/alger      # slug francez
GET /v1/forecast/city/dz/algiers    # slug englez — același oraș
GET /v1/forecast/city/fr/paris

country este un cod ISO-3166-1 alpha-2, cu litere mici. slug ignoră diacriticele: bejaia găsește Béjaïa. Un slug necunoscut întoarce 404 city_not_found cu un vector suggestions — arătați-l în loc de o fundătură.

Toți parametrii de interogare de la /v1/forecast rămân valabili, în afară de lat, lon și elevation, pe care le dă catalogul. Transmiterea unui timezone îl suprascrie pe cel al orașului, ceea ce aproape niciodată nu e ce vreți.

Condiții curente#

Temperatura, umiditatea, vântul și presiunea sunt interpolate liniar la momentul curent, între cei doi pași ai modelului care îl încadrează.

Folosiți asta pentru un afișaj „chiar acum”. Pentru orice veți compara în timp, folosiți /v1/forecast și citiți ora dorită: seria e stabilă, în timp ce acum se mișcă sub dumneavoastră între două apeluri.

Referința câmpurilor#

Câmpuri orare

21 dintre ele se întorc implicit. Restul sunt ale dumneavoastră la cerere — numiți-le în hourly=, separate prin virgulă — și sunt ținute deoparte din cauza costului, nu a îndoielii: fiecare câmp stocat e o citire comprimată separată, deci un răspuns implicit care le-ar aduce pe toate 45 i-ar face pe toți să plătească pentru cei câțiva care vor grosimea zăpezii.

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

Un câmp pe care un model nu îl publică se întoarce ca null pe porțiunea de prognoză a acelui model, în loc să dispară din răspuns — deci un lanț care începe pe AROME și continuă pe ICON-EU întoarce visibility peste tot, nul în primele 51 de ore. Un nume de câmp necunoscut înseamnă 400 unknown_field, cu cea mai apropiată potrivire sugerată; înainte era ignorat în tăcere.

Câmpuri zilnice

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.

Agregate pe zile calendaristice locale, nu pe UTC. O zi parțială la oricare capăt al intervalului este omisă în loc să fie raportată cu un maxim înșelător — deci o cerere de 7 zile poate întoarce pe bună dreptate 6 rânduri zilnice.

Modele și rezoluție#

Servim cel mai fin model care acoperă punctul dumneavoastră și termenul dumneavoastră. Nu alegeți niciodată unul; alegerea e raportată în source.model, ca să știți mereu care a răspuns.

Modelele de înaltă rezoluție sunt toate de scurtă durată — la 1 km atmosfera devine haotică în două zile, deci o prognoză mai lungă n-ar avea sens — iar rezoluția coboară deci în trepte pe măsură ce prognoza avansează:

ziua 0 ────── ziua 2 ────── ziua 5 ──────────────── ziua 15
  AROME 1,3 km (Franța)
  ICON-D2 2,2 km (Germania, Alpi, Benelux)
  HRRR 3 km (SUA și sudul Canadei)
              ICON-EU 6,5 km (Europa)
                          ICON 13 km · ECMWF 28 km (global)
                                              AIFS (doar tendință)

Tranzițiile peste marginea domeniului unui model sunt estompate reciproc, astfel încât două localități de o parte și de alta a unei granițe nu diferă niciodată printr-un salt.

/v1/models nu cere cheie, ceea ce îl face potrivit de interogat dintr-o pagină de stare sau de verificat înainte să cumpărați: raportează cea mai recentă rulare a fiecărui model și vechimea ei, deci la „sunt datele proaspete?” se poate răspunde fără să cheltuiți un credit.

Probabilități de ansamblu#

O prognoză unică spune 22 °C joi. Aceea e o presupunere prezentată ca un fapt. Endpointul acesta răspunde la întrebarea pe baza căreia decideți de fapt: cât de sigur e și ce probabilitate de ploaie merită luată în calcul.

Se calculează din ansamblul ECMWF — același model rulat de 50 de ori din condiții inițiale ușor diferite. Acolo unde rulările sunt de acord, prognoza e sigură. Acolo unde se împrăștie, însăși atmosfera e incertă și niciun model, oricât de bun, nu vă poate spune mai mult.

{
  "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]
  }
}

Cum se citește

p10 și p90 încadrează 80 % din mijlocul membrilor: unul din zece se așteaptă să fie mai frig decât p10, unul din zece mai cald decât p90. Un spread de 0,4 °C e o situație așezată, în care puteți avea încredere; 3 °C înseamnă că modelele nu sunt de acord și ar trebui să le spuneți asta utilizatorilor în loc să alegeți unul.

Pragurile de ploaie sunt decizii, nu cifre rotunde — 0,1 mm înseamnă ud, cât de cât, 1 mm înseamnă ia-ți o haină, 5 și 10 mm înseamnă asta e o problemă. precipitation_p90 e cazul nefavorabil: doar un membru din zece e mai ploios.

Calitatea aerului#

Acesta e endpointul care contează cel mai mult în nordul Africii și în Mediterana. Un episod de praf duce PM10 peste o mie de micrograme pe metru cub zile la rând, ceea ce e o decizie de sănătate, nu o cifră, și e slab acoperit de serviciile gratuite pentru consumatori.

{
  "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"}
}

Toate concentrațiile sunt în µg/m³, unitatea în care se raportează peste tot calitatea aerului. dust_aod_550nm e o adâncime optică și nu are unitate: peste circa 0,5 cerul e vizibil cețos, peste 1,0 soarele e estompat.

Valorile-ghid pe termen scurt ale OMS călătoresc în fiecare răspuns, ca o cifră să poată fi plasată fără să fie căutată. band urmează indicele european al calității aerului pentru PM2,5: bună, acceptabilă, moderată, slabă, foarte slabă, extrem de slabă.

Zăpada și limita zăpezii#

Patru câmpuri, și răspund la întrebări diferite. snowfall e cât cade; restul descriu ce e la sol și unde.

Cereți-le pe nume — nu sunt în răspunsul implicit:

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

Limita zăpezii e cea care merită citită. „Plouă la 800 m și ninge la 1200” e o informație pe care o stațiune de schi, o administrație rutieră sau un șofer pot acționa; „3 mm de precipitații” nu este. Contează și în nordul Africii — Atlasul are domenii de schi la Chréa și Tikjda, iar podișurile înalte de la Sétif, Batna și Djelfa stau peste 1000 m.

Acestea vin de la ICON-ul DWD, care acoperă lumea la 13 km. Datele deschise ale ECMWF publică grosimea zăpezii, dar nu limita zăpezii, deci ăsta e unul dintre locurile unde modelul mai grosier e cel mai util. snow_line_altitude e un produs regional: ICON-EU și ICON-D2 îl publică, ICON global nu, deci în afara Europei primiți nivelul de îngheț și grosimea, dar nu și limita.

Marin — starea mării#

{
  "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]
  }
}

Înălțimea valurilor este înălțimea semnificativă — media treimii celor mai înalte valuri, cam ce raportează un observator pe mare. Valurile individuale ajung la aproximativ dublul ei, și acela e numărul care contează dacă hotărâți dacă ieșiți în larg. Direcția e cea din care vin valurile, ca la vânt.

Râuri#

Răspunde la ceva ce niciun model meteo nu poate: nu câtă ploaie cade în amonte, ci câtă apă ajunge aici — un număr diferit, despărțit de ploaie printr-un bazin, printr-o stare de umiditate a solului și printr-o zi-două de timp de propagare.

{
  "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]
  }
}