Weer-API — verwachtingen tot 15 dagen van ECMWF, ICON, HRRR en AROME

Dezelfde 120 km kust, zoals elk model die ziet 28 km de baai is weg 1.3 km het eiland bestaat

Resolutie is geen detail uit een specificatieblad. Ze bepaalt of een baai, een dal of een eiland überhaupt in het model zit — en een cel die zee en land middelt geeft u de temperatuur van geen van beide.

8 modellen, automatisch opgelost

U kiest nooit een model. U stuurt een coördinaat; de API neemt het fijnste dat die dekt, mengt over domeinranden zodat de waarde niet springt, en vertelt in het antwoord welk model antwoordde.

Weermodellen, resolutie, dekking, runs en termijn
Model	Resolutie	Dekking	Runs	Termijn	Beschikbaar na
Météo-France AROME	1.3 km	Frankrijk en directe buren	8 ×/dag	51 h	4 h
DWD ICON-D2	2.2 km	Midden-Europa	4 ×/dag	48 h	2 h
NOAA HRRR	3 km	Continentale Verenigde Staten	4 ×/dag	48 h	1.5 h
DWD ICON-EU	6.5 km	Europa, Noord-Afrika, Nabije Oosten	2 ×/dag	120 h	3 h
DWD ICON	13 km	Wereld	2 ×/dag	180 h	4 h
ECMWF IFS	28 km	Wereld — altijd aanwezig	2 ×/dag	240 h	7 h
ECMWF AIFS	28 km	Wereld, dag 11–15	2 ×/dag	360 h	7 h
ECMWF wave	28 km	Alleen oceanen en zeeën	2 ×/dag	240 h	7 h

Domeinranden

Geen naad waar een model ophoudt

Abrupt van model wisselen op een grens laat twee buurdorpen zonder fysische reden uiteenlopen. Elk domein draagt een mengmarge: bij de rand neemt het gewicht van het fijne model af en gaat de rest naar het volgende. Binnen het domein krijgt u het fijne model onvermengd.

Termijn

Vroeg fijn, later globaal

AROME stopt bij 51 uur en HRRR bij 48. Daarna valt de resolver via ICON-EU en ICON terug op ECMWF, in dezelfde aanvraag. Uw reeks van zeven dagen is aan elkaar genaaid uit het model dat op elke stap het beste was, en het antwoord legt de mix vast.

Wat terugkomt

45 uurvelden — 27 opgeslagen, 18 ter plekke berekend. 21 komen standaard terug; noem de rest in hourly=, of noem er minder en maak het antwoord kleiner.

Temperatuur & vocht

temperature_2m, dagmaximum en -minimum, dewpoint_2m, relatieve vochtigheid, gevoelde temperatuur, hitte-index, windchill, oppervlaktetemperatuur.

Wind

u/v-componenten op 10 m en 100 m voor de windenergiemarkt, snelheid, richting, windstreek, Beaufortkracht en wind_gust_10m.

Neerslag

Totale neerslag per interval gedecumuleerd, sneeuwval als wateraequivalent, en een WMO-code precipitation_type die regen, sneeuw en ijzel scheidt.

Bewolking & zicht

Totale bedekking plus laag, midden en hoog apart — lage bewolking maakt een dag grijs, cirrus dempt de zon nauwelijks. Okta's voor de luchtvaart en visibility voor mist.

Straling & zon

Kortgolvige instraling, gesplitst in direct en diffuus voor zonopbrengst. Zonshoogte en azimut, daglichtvlag, zonsop- en -ondergang, en een geschatte UV-index.

Druk & instabiliteit

Druk op zeeniveau en aan het oppervlak, drieuurstendens, cape voor convectief potentieel, en de totale waterdamp in de kolom.

Bodem

Bodemtemperatuur aan het oppervlak en in de wortelzone 7–28 cm — de laag waar de landbouw om geeft — uit ICON. soil_temperature_0cm en soil_temperature_8cm.

Sneeuw

Dikte, wateraequivalent, vriesniveau en snow_line_altitude — de hoogte waarboven neerslag als sneeuw valt, en dat is een beslissing waar een wegbeheerder iets mee kan.

Samenvatting

Eén WMO-weather_code per tijdstap, zodat de client één icoon tekent in plaats van de logica na te bouwen die zeven velden tot „lichte regen” maakt.

Twee correcties die de meeste API's overslaan

Hoogte

De berg van het model is niet uw berg

Een numeriek model strijkt het reliëf glad naar zijn raster. Een dorp in een dal kan 400 m onder de hoogte liggen die het model eraan toekent, en de ruwe temperatuur is fout met de temperatuurgradiënt over dat verschil.

Stuur elevation mee en de waarde wordt gecorrigeerd tegen de orografie van het model zelf. In heuvelland is dat doorgaans 1–3 °C waard. Het antwoord meldt de modelhoogte, uw hoogte en de toegepaste verschuiving — u kunt het dus controleren of negeren.

Versheid

Verouderd wint van afwezig, en zegt het

Is onze nieuwste run ouder dan verwacht, dan krijgt u nog steeds gegevens, met "stale": true en data_age_hours in het blok source. Een verwachting van acht uur oud is voor uw gebruikers nuttiger dan een 500.

Wat u nooit krijgt is een verouderd getal dat er vers uitziet. Beslis in uw eigen code of u het toont, waarschuwt of terugvalt.

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

Op dezelfde sleutel, niet op nog een factuur

Vier dingen die elders meestal aparte producten zijn. Hier zijn het eindpunten op het abonnement dat u al hebt.

/v1/probability

Hoe zeker is de verwachting?

Eén waarde zegt 22 °C op donderdag — een gok als feit gepresenteerd. Dit geeft p10, p50, p90 en de spreiding uit het 50-ledige ensemble van ECMWF, plus regenkansen bij 0,1, 1, 5 en 10 mm.

Een spreiding van 0,4 °C is een uitgekristalliseerde situatie. Een spreiding van 3 °C betekent dat de atmosfeer zelf onzeker is, en uw gebruikers verdienen dat te horen.

/v1/air-quality

Fijnstof, ozon, NO₂ — en Saharastof

Van Copernicus CAMS, met de WHO-richtwaarden in elk antwoord, zodat een getal kan worden geplaatst zonder het op te zoeken.

Stof telt in Noord-Afrika en het Middellandse Zeegebied: een episode duwt PM10 dagenlang boven duizend µg/m³, en gratis consumentendiensten dekken dat slecht af.

/v1/marine

Zeegang wereldwijd

Significante golfhoogte, richting en periode uit het golfmodel van ECMWF, tot tien dagen. Een punt op het land geeft 404 not_at_sea in plaats van een kolom nullen die op een storing lijkt.

/v1/hydrology

Hoeveel water hier aankomt

Rivierafvoer van Copernicus GloFAS op een riviernetwerk van 0,05° — niet hoeveel regen er stroomopwaarts valt, maar hoeveel water dit punt bereikt, waar een stroomgebied en een dag looptijd tussen zitten.

Alleen ter informatie. Hoogwaterwaarschuwingen uitgeven is voorbehouden aan nationale en regionale autoriteiten.

Waar het aan het werk gaat

Weerproducten

Stadspagina's, apps en widgets. Eén WMO-code per stap voor het icoon, dagaggregaten gesneden in de tijdzone van de gebruiker, en een stedencatalogus met zoeken en dichtstbijzijnde punt.

Energie

Wind op 100 m voor de ashoogte, directe en diffuse instraling voor pv-opbrengst, en ensemblespreiding voor de risicokant van een positie.

Landbouw

Bodemtemperatuur en -vocht op vier diepten, invoer voor verdamping, vorstrisico uit de minimumtemperatuur, en windstoten voor spuitvensters.

Logistiek & wegen

Sneeuwgrens, vriesniveau, neerslagtype en zicht — de vier velden die bepalen of een bergpas dichtgaat.

Maritiem & outdoor

Golfhoogte, -periode en -richting, windstoten, UV-index en daglicht voor planning die een week vooruit moet.

Wederverkopers

U mag herverspreiden. Bouw er een product op en verkoop het, met één regel bronvermelding in de voettekst als enige verplichting die u volgt.

Wat het slecht doet

Wij hebben liever dat u de grenzen nu kent dan dat u ze in productie vindt.

Sterk

Temperatuur, druk, synoptische wind, vochtigheid, zonneschijn. De typische fout in de temperatuur op 2 m na 24 uur ligt rond 1–1,5 °C. ECMWF is het beste globale deterministische model ter wereld, en dat is wat u krijgt.

Zwak

Convectieve buien — een cel van 28 km kan geen onweer oplossen, en zelfs 3 km hint er slechts naar. Precieze plaats en tijd van buien. Kust- en bergmicroklimaat onder de modelresolutie. Zeewind en koudeluchtmeren in dalen, die de hoogtecorrectie niet modelleert.

Geografisch eerlijk

In Frankrijk, Duitsland, de Verenigde Staten en Canada leveren we nationale modellen op 1,3–3 km en krijgt een klein dorp echt zijn eigen cel. Overzeese gebieden, Alaska, Hawaï en Noord-Canada vallen buiten die domeinen en komen op 13 km uit. Elders in Europa krijgt u 6,5 km. In Afrika, het Midden-Oosten en het grootste deel van Azië is het beste beschikbare publieke model 13–28 km: u krijgt het weer van de streek in plaats van dat van de straat. De hoogtecorrectie verkleint dat gat; ze sluit het niet.

Geen waarschuwingsdienst

Geen alarmen, geen waarschuwingskleuren, geen opdracht tot handelen. Dat hoort bij de autoriteiten, die ook een weg kunnen afsluiten en een dorp kunnen evacueren.

Veelgestelde vragen

Welk model bedient mijn locatie?

Het fijnste dat haar dekt: AROME op 1,3 km in Frankrijk, ICON-D2 op 2,2 km in Midden-Europa, HRRR op 3 km in de Verenigde Staten, ICON-EU op 6,5 km over Europa en Noord-Afrika, ICON op 13 km wereldwijd, en ECMWF IFS op 28 km als altijd aanwezige basis.

Roep /v1/models aan voor het huidige register en het domein van elk model, of lees source.model in elk antwoord.

Hoe vaak wordt het bijgewerkt?

Globale modellen tweemaal daags om 00 en 12 UTC; de hogeresolutie nationale modellen viermaal daags om 00, 06, 12 en 18 UTC. De gegevens worden bruikbaar tussen 90 minuten en 7 uur na de runtijd, afhankelijk van de leverancier — de tabel hierboven geeft ze stuk voor stuk.

Verwachtingsantwoorden worden vijf minuten aan de rand gecachet, wat het herhaalde verkeer van stadspagina's opvangt zonder ooit een run te leveren die achterloopt op die van ons.

Kan ik veel locaties tegelijk opvragen?

Eén coördinaat per aanvraag. De opslag is zo in blokken gedeeld dat de hele tijdreeks van een klein gebied in één blok past — één punt over alle stappen is de goedkope query, en het is degene die vrijwel elk product werkelijk stelt.

Voor stadsvormig verkeer draagt /v1/forecast/city/{country}/{slug} de tijdzone en de hoogte van de stad, zodat u dat niet hoeft.

Is er een bulkdownload?

Nee, in geen enkel abonnement. Het archief is waarvoor u betaalt, en een onbegrensde export is de manier waarop een concurrent het in één middag verwerft. De CSV-export voor graaddagen bestaat en is bewust begrensd.

Wat kost het?

Gratis voor 10.000 credits per maand zonder kaart. € 19 per maand voor 50.000 credits inclusief de Graaddagen-API, historie en CSV. € 79 voor 400.000 credits en al het overige. Een verwachtingsaanvraag is één credit.

Volledige prijzen →

Probeer het op uw eigen coördinaten

De gratis laag geeft dezelfde gegevens als de betaalde. Richt hem op een plek die u goed kent en beoordeel de getallen zelf.

Gratis sleutel aanvragen Referentie van het verwachtingseindpunt

Het fijnste model dat uw punt dekt. Per aanvraag gekozen.