KNMI API koppelen aan je website.

Het KNMI is het Koninklijk Nederlands Meteorologisch Instituut: de instantie die in Nederland het weer meet en verwacht. Het KNMI Data Platform (KDP) is de plek waar het instituut die gegevens als open data beschikbaar stelt, voor iedereen die ze wil gebruiken.

Daar staan onder meer de waarnemingen van de weerstations per tien minuten, per uur, per dag, per maand en per jaar, en de uitvoer van het weermodel HARMONIE voor Nederland, Europa en het Caribisch gebied. De meeste gegevens zijn gratis en staan onder de open licentie CC BY 4.0.

Voor ontwikkelaars is er een Developer Portal met de API's: de Open Data API, de EDR API, een kaartdienst (WMS) en de Notification Service. Je maakt er een account aan en vraagt per toepassing een sleutel aan.

De Open Data API levert bestanden. Je vraagt de lijst van bestanden in een dataset op, kiest het bestand dat je nodig hebt, en krijgt een tijdelijke link om het te downloaden. De waarnemingen per tien minuten komen bijvoorbeeld als NetCDF-bestand met alle stations erin. Dat is de route voor wie veel gegevens tegelijk wil verwerken.

De EDR API is gemaakt om precies te vragen wat je nodig hebt: één parameter, op één locatie of in een gebied, over een bepaalde periode. Het antwoord komt als CoverageJSON en is veel kleiner dan een heel bestand. Voor een weerblok met de temperatuur en neerslag van het station bij jou in de buurt is dat de logische route.

Beide werken met een sleutel in de Authorization-header en hebben dezelfde grens van 1.000 aanvragen per uur voor een geregistreerde sleutel. Met een cache op de server kom je daar bij een website niet in de buurt.

Waarnemingen zijn wat er gemeten is: de temperatuur, wind en neerslag van het afgelopen kwartier of de afgelopen dag. Die zijn kant-en-klaar te gebruiken en geven een site iets actueels, zoals "nu 17 graden en droog" bij de ingang van een camping.

Een weersverwachting op je website is een ander verhaal. Het KNMI levert de verwachting als uitvoer van het weermodel HARMONIE, in GRIB-bestanden met waarden per uur voor een raster over het land. Dat is geen weerbericht in gewone taal. Om er "morgen zon, 22 graden" van te maken, halen we het bestand op de server op, lezen we de waarden voor jouw locatie uit en zetten we die om naar iets wat een bezoeker in één oogopslag leest.

Het kan, en het blijft dicht bij de officiële bron. Het vraagt wel meer werk dan een widget. Daarom bespreken we eerst wat je bezoeker echt moet weten: is het vandaag droog, wordt het warm genoeg voor het terras, of moet de buitenactiviteit naar binnen.

Voor een recreatiebedrijf hoort het weer bij de keuze. Een gast die twijfelt tussen twee dagen, kijkt naar het weer en naar de beschikbaarheid. Staat je aanbod via Recras of Booking Experts op de site, dan kan het weer daar direct naast staan, of kan een activiteitenpagina bij een natte verwachting het binnenprogramma eerst laten zien.

Voor horeca met een terras of een strandpaviljoen is het eenvoudiger: is het vandaag terrasweer. Een klein blok bovenaan de pagina, bij de openingstijden, zegt meer dan een widget onderaan. Hoe dat samengaat met menukaart en reserveren lees je bij een website voor je horecazaak.

En er is een derde toepassing: terugkijken. Een evenement dat wil laten zien hoe vaak het in juni droog was, of een verhuurder die wil uitleggen waarom hij in een bepaalde maand meer vraagt, haalt dat uit de historische waarnemingen. Die staan op hetzelfde platform.

Wie zoekt naar een weer-API vindt meer dan het KNMI: Buienradar, en diensten als Weerlive, Meteoserver, Open-Meteo en OpenWeatherMap. Ze verschillen in bron, in vorm en in wat je ermee mag, en een deel levert de verwachting al in gewone taal.

Buienradar zet een JSON-feed met waarnemingen online die elke tien minuten wordt ververst. Die mag je gratis gebruiken op je eigen website, maar alleen voor niet-commerciële doeleinden, met een bronvermelding en een link naar buienradar.nl. Voor commercieel gebruik vraag je eerst toestemming aan Buienradar. Voor een bedrijfssite gaan wij daar altijd van uit.

Voor andere aanbieders lezen we per geval de voorwaarden na, omdat die per dienst verschillen in limieten, prijs en wat je erbij moet vermelden. Het KNMI zelf heeft het voordeel dat de licentie helder is en de bron officieel.

Op WordPress maken we een blok dat je op elke pagina kunt plaatsen, in de opmaak van je thema. Een kleine uitbreiding op de server haalt de gegevens op een vast ritme op, bewaart ze in de database en levert ze aan het blok. De sleutel blijft op de server en de bezoeker merkt niets van een aanvraag.

Op een maatwerksite in Next.js is het een serverroute met een cache, eventueel met een melding van de Notification Service als trigger voor een nieuwe verwachting. Dat is de route als het weer meer bepaalt dan een blok, zoals de volgorde van activiteiten of de tekst van een bevestigingsmail.

Het weerblok en de techniek erachter vallen bij ons onder Design & Development.