Weer-API

Verwachting#

Parameters

Antwoord

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

De payload verkleinen

Het volledige uurblok over 15 dagen is ongeveer 32 velden × 360 uur. Als u er drie uitzet, vraag er dan drie op:

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

Dezelfde prijs — de kosten zitten in het lezen van het archief, niet in het serialiseren — maar een tiende van de bytes en merkbaar sneller te verwerken op een telefoon.

Verwachting per stad#

Geef hieraan de voorkeur boven ruwe coördinaten waar dat kan. De catalogus levert twee dingen die een coördinaat niet kan geven: de werkelijke hoogte van de stad, zodat de terreincorrectie werkt zonder dat u die opgeeft, en haar tijdzone, zodat de dagaggregaten op de juiste lokale dag worden afgesneden.

GET /v1/forecast/city/dz/alger      # Franse slug
GET /v1/forecast/city/dz/algiers    # Engelse slug — dezelfde stad
GET /v1/forecast/city/fr/paris

country is een ISO-3166-1 alpha-2-code in kleine letters. slug is ongevoelig voor accenten: bejaia vindt Béjaïa. Een onbekende slug geeft 404 city_not_found met een suggestions-array — toon die in plaats van een doodlopend spoor.

Alle queryparameters van /v1/forecast gelden nog steeds, behalve lat, lon en elevation, die de catalogus levert. timezone meegeven overschrijft die van de stad, wat vrijwel nooit is wat u wilt.

Actuele omstandigheden#

Temperatuur, luchtvochtigheid, wind en druk worden lineair geïnterpoleerd naar het huidige moment, tussen de twee modelstappen die het omsluiten.

Gebruik dit voor een „op dit moment”-weergave. Voor alles wat u door de tijd heen vergelijkt, gebruik /v1/forecast en lees het uur dat u wilt: de reeks is stabiel, terwijl nu tussen twee aanroepen onder u wegschuift.

Veldreferentie#

Uurvelden

21 daarvan komen standaard terug. De rest is voor u zodra u erom vraagt — noem ze in hourly=, door komma's gescheiden — en ze worden achtergehouden vanwege de kosten, niet uit twijfel: elk opgeslagen veld is een aparte gecomprimeerde leesbewerking, zodat een standaardantwoord met alle 45 elke aanroeper zou laten betalen voor de enkelingen die de sneeuwdikte willen.

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

Een veld dat een model niet publiceert komt terug als null voor het deel van de verwachting van dat model, in plaats van uit het antwoord te verdwijnen — zodat een keten die op AROME begint en op ICON-EU doorloopt visibility van begin tot eind teruggeeft, null voor de eerste 51 uur. Een onbekende veldnaam levert een 400 unknown_field op, met de dichtstbijzijnde overeenkomst als suggestie; vroeger werd hij stilzwijgend genegeerd.

Dagvelden

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.

Geaggregeerd op lokale kalenderdagen, niet UTC. Een gedeeltelijke dag aan een van beide uiteinden van het bereik wordt weggelaten in plaats van gerapporteerd met een misleidend maximum — een verzoek van 7 dagen kan dus gerechtvaardigd 6 dagrijen teruggeven.

Modellen en resolutie#

Wij leveren het fijnste model dat zowel uw punt als uw termijn dekt. U kiest er nooit zelf een; de keuze wordt gemeld in source.model, zodat u altijd kunt zien welk model heeft geantwoord.

Hogeresolutiemodellen zijn allemaal kortetermijnmodellen — bij 1 km wordt de atmosfeer binnen twee dagen chaotisch, dus verder vooruit rekenen zou zinloos zijn — en de resolutie daalt daarom trapsgewijs naarmate de verwachting vordert:

dag 0 ─────── dag 2 ─────── dag 5 ───────────────── dag 15
  AROME 1,3 km (Frankrijk)
  ICON-D2 2,2 km (Duitsland, Alpen, Benelux)
  HRRR 3 km (VS en zuidelijk Canada)
              ICON-EU 6,5 km (Europa)
                          ICON 13 km · ECMWF 28 km (globaal)
                                              AIFS (alleen trend)

Overgangen aan de rand van een modelgebied worden overvloeid, zodat twee plaatsen aan weerszijden van een grens nooit door een sprong van elkaar afwijken.

/v1/models heeft geen sleutel nodig, waardoor het het juiste endpoint is om vanaf een statuspagina te bevragen of vóór aanschaf te controleren: het meldt de laatste run van elk model en de ouderdom ervan, zodat „is de data vers” te beantwoorden is zonder een credit uit te geven.

Ensemblekansen#

Eén enkele verwachting zegt 22 °C op donderdag. Dat is een gok die als feit wordt gepresenteerd. Dit endpoint beantwoordt de vraag waarop u werkelijk beslist: hoe zeker is het, en welke regenkans is het waard om zich op te organiseren.

Het wordt berekend uit het ensemble van het ECMWF — hetzelfde model 50 keer gedraaid vanuit licht verschillende beginvoorwaarden. Waar de runs het eens zijn, is de verwachting zeker. Waar ze uiteenlopen, is de atmosfeer zelf onzeker, en geen enkel model, hoe goed ook, kan u meer vertellen.

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

Hoe u het leest

p10 en p90 omsluiten de middelste 80 % van de leden: één op de tien verwacht het kouder dan p10, één op de tien warmer dan p90. Een spread van 0,4 °C is een gevestigde situatie waarop u kunt vertrouwen; 3 °C betekent dat de modellen het oneens zijn en dat u dat beter aan uw gebruikers kunt zeggen dan er één te kiezen.

De regendrempels zijn beslissingen en geen ronde getallen — 0,1 mm is überhaupt nat, 1 mm is neem een jas mee, 5 en 10 mm zijn dit wordt een probleem. precipitation_p90 is het ongunstige geval: slechts één op de tien leden is natter.

Luchtkwaliteit#

Dit is het endpoint dat in Noord-Afrika en het Middellandse Zeegebied het zwaarst weegt. Een stofepisode duwt PM10 dagenlang voorbij duizend microgram per kubieke meter, wat eerder een gezondheidsbeslissing is dan een getal, en het wordt slecht gedekt door gratis consumentendiensten.

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

Alle concentraties zijn in µg/m³, de eenheid waarin luchtkwaliteit overal wordt genoemd. dust_aod_550nm is een optische dikte en heeft geen eenheid: boven ongeveer 0,5 is de hemel zichtbaar heiig, boven 1,0 is de zon gedempt.

De kortetermijnrichtwaarden van de WHO reizen in elk antwoord mee, zodat een getal geplaatst kan worden zonder het op te zoeken. band volgt de Europese luchtkwaliteitsindex voor PM2,5: goed, redelijk, matig, slecht, zeer slecht, uiterst slecht.

Sneeuw en de sneeuwgrens#

Vier velden, en ze beantwoorden verschillende vragen. snowfall is hoeveel er valt; de rest beschrijft wat er op de grond ligt, en waar.

Vraag ze bij naam op — ze zitten niet in het standaardantwoord:

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

De sneeuwgrens is degene die het lezen waard is. „Het regent op 800 m en het sneeuwt op 1200” is iets waar een skigebied, een wegbeheerder of een automobilist naar kan handelen; „3 mm neerslag” niet. Het telt ook in Noord-Afrika — de Atlas heeft skigebieden bij Chréa en Tikjda, en de hoogvlakten van Sétif, Batna en Djelfa liggen boven 1000 m.

Deze velden komen uit ICON van de DWD, dat de wereld op 13 km dekt. De open data van het ECMWF publiceren de sneeuwdikte maar niet de sneeuwgrens: dit is dus een geval waarin het grovere model het nuttigste is. snow_line_altitude is een regionaal product — ICON-EU en ICON-D2 publiceren het, ICON globaal niet, dus buiten Europa krijgt u de isotherm en de dikte, maar niet de grens zelf.

Zee — zeegang#

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

De golfhoogte is de significante golfhoogte — het gemiddelde van het hoogste derde deel van de golven, wat ongeveer overeenkomt met wat een waarnemer op zee meldt. Afzonderlijke golven halen ongeveer het dubbele, en dat is het getal dat telt als u beslist of u uitvaart. De richting is die waaruit de golven komen, net als bij de windrichting.

Rivieren#

Dit beantwoordt wat geen enkel weermodel kan: niet hoeveel regen er stroomopwaarts valt, maar hoeveel water er hier aankomt — een heel ander getal, van de regen gescheiden door een stroomgebied, een bodemvochttoestand en een dag of twee reistijd.

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