Wunderground API key aanvragen als weerstation eigenaar
Je hebt een weerstation in de tuin of op het balkon. Superleuk, al die data over temperatuur, luchtdruk en neerslag.
Maar wat als je die gegevens wilt delen op je eigen website, in een app wilt stoppen of wilt koppelen aan je slimme huis? Dan heb je een sleutel nodig: de Wunderground API key. Dat klinkt technisch, maar het is eigenlijk gewoon een toegangspasje. Ik leg je precies uit hoe je die regelt.
Wat is die Wunderground API key eigenlijk?
Stel je voor: je weerstation praat met het internet. Het stuurt zijn metingen naar Weather Underground, een grote online community van weerliefhebbers.
Dat platform verzamelt al die data van duizenden stations wereldwijd. De API key is jouw persoonlijke toegangscode om die enorme schat aan informatie weer op te halen, of om je eigen stationgegevens ergens anders te gebruiken. Zonder zo'n key kun je nergens bij.
Het is een beetje als een abonnement op de bieb: zonder pasje kom je de deur niet in.
Met de key kun je bijvoorbeeld de huidige temperatuur van je eigen station op je website tonen, of de voorspelling voor jouw straat ophalen in een domotica-systeem.
Waarom zou je er eentje aanvragen?
De belangrijkste reden is simpel: controle. Je hebt geld uitgegeven aan een weerstation van bijvoorbeeld Davis Instruments, Netatmo of Ecowitt.
Dan wil je die data toch ook zelf kunnen gebruiken? Met een API key ben je niet langer afhankelijk van de app van de fabrikant.
Het opent een wereld aan mogelijkheden. Je kunt je eigen dashboard bouwen, de data integreren met Home Assistant of gebruikmaken van de Wunderground API voor je eigen projecten, zoals het automatisch aansturen van je tuinberegening op basis van de neerslagmeting van je eigen station. Het voegt echt een laag toe aan wat je met je hobby kunt doen.
Zo vraag je die key stap voor stap aan
Het proces is gelukkig niet ingewikkeld. Het begint allemaal op de website van Weather Underground, waar je ook meer leest over hoe de API-limitatie precies werkt.
Je hebt een gratis account nodig. Als je al een station hebt ingestuurd, heb je die waarschijnlijk al.
- Ga naar de Weather Underground website en log in op je account.
- Zoek naar de pagina voor API's. Dat staat vaak onder een kopje 'Developers' of 'API' in de footer of bij je accountinstellingen.
- Kies voor het aanvragen van een 'API Key'. Je krijgt dan een formulier te zien.
- Vul de gevraagde gegevens in. Vaak gaat het om je naam, e-mail en waarvoor je de key gaat gebruiken. Wees hier eerlijk en duidelijk. Schrijf bijvoorbeeld: "Om de gegevens van mijn persoonlijke weerstation (ID: IJMOND123) op mijn smart home dashboard te tonen."
- Je krijgt dan direct een lange reeks letters en cijfers te zien. Dat is je key! Kopieer die en bewaar 'm goed, bijvoorbeeld in een wachtwoordmanager.
Belangrijk: deel je key nooit zomaar op forums of met vreemden. Het is een unieke sleutel die aan jouw account is gekoppeld.
De verschillende soorten abonnementen en wat ze kosten
Weather Underground biedt meerdere opties aan. Voor de meeste hobbyisten is de gratis versie meer dan genoeg.
- Gratis abonnement: Dit is waar je begint. Je krijgt een beperkt aantal verzoeken per dag (bijvoorbeeld 500) en per minuut. Voor het uitlezen van je eigen station of het tonen van een widget op je persoonlijke blog is dit ruim voldoende.
- Betaalde abonnementen: Deze zijn bedoeld voor ontwikkelaars of commerciële toepassingen. De prijzen beginnen bij ongeveer $20 per maand voor meer verzoeken en hogere snelheid. Tenzij je een bedrijf start met weerdata, heb je dit niet nodig.
De key die je aanvraagt via het standaard 'Developer'-programma is in de basis dus gratis. Pas als je heel veel data gaat opvragen, krijg je een melding dat je moet upgraden, of als je besluit om je weerstation aan Windy te koppelen.
Praktische tips voor als je aan de slag gaat
Een key hebben is één ding, hem goed gebruiken is twee. Hier zijn wat dingen die ik heb geleerd. Bewaar je key goed. Zet 'm niet in openbare code op GitHub.
Gebruik in je scripts een apart bestandje of omgevingsvariabele om de key op te slaan.
Zo voorkom je dat iemand anders jouw limiet opmaakt. Begin klein. Probeer eerst simpelweg de huidige weersomstandigheden van je eigen station op te halen via een eenvoudig script.
Pas als dat werkt, ga je complexere dingen bouwen. De documentatie op de ontwikkelaarspagina is daarbij je beste vriend. Let op de limieten. Bij de gratis versie is het slim om in je code te zorgen dat je niet elke seconde een verzoek doet.
Cache de data bijvoorbeeld 5 minuten. Zo blijf je ruim binnen je limieten en voorkom je foutmeldingen.
Het aanvragen van die key is echt het begin van een leuk avontuur. Het geeft je de sleutel tot de data die je zelf verzamelt. Veel plezier met bouwen!