Maak je gebruik van OpenWeatherMap, bijvoorbeeld binnen Home Assistant? Dan moet je er rekening mee houden dat API v2.5 binnenkort niet meer werkt. Je zult de API v3.0 moeten gaan gebruiken. Hier zijn wat wat aanpassingen voor nodig. Zo zul je een abonnement moeten kiezen, wat ook een gratis abonnement kan zijn. En er zijn kleine aanpassingen in Home Assistant nodig.
Wat is OpenWeatherMap?
Met OpenWeatherMap kun je via een zogenoemde API weersgegevens raadplegen. Dit levert verschillende sensoren op die je bijvoorbeeld binnen Home Assistant kunt gebruiken.
Over de nieuwe API v3.0
OpenWeatherMap heeft al enige tijd de nieuwe API v3.0. Veel gebruikers van onder andere Home Assistant werken nog met de oude API v2.5. In juni 2024 zal de oude versie echter worden afgesloten. Daarom moeten aanvragen voortaan via de nieuwe API worden gedaan.
Net als voorheen geldt dat de eerste 1.000 aanvragen via de API gratis zijn. Als er meer aanvragen worden gedaan, betaal je daarvoor een tarief van €0,14 per 100 aanvragen. In de praktijk zul je, bijvoorbeeld in combinatie met Home Assistant, genoeg hebben aan 1.000 aanvragen.
De nieuwe API v3.0 vereist dat je een One Call API 3.0 abonnement afsluit. Hierbij is het nodig om je creditcard-gegevens te verstrekken. Als je onder de 1.000 aanvragen blijft zal er echter niets worden geïncasseerd. Bij het afsluiten van het abonnement kun je een limiet voor het aantal aanvragen per dag instellen. Zo kun je de kosten beperken. Standaard is deze limiet 2.000 aanvragen. Als je dit aanpast naar maximaal 1.000 aanvragen per dag zal er in principe nooit iets worden geïncasseerd. Aanvragen voorbij de limiet resultaten in een foutmelding.
Stappenplan bestaande gebruikers
Maak je al gebruik van OpenWeatherMap? Ga naar https://openweathermap.org/ en log in met je account. Ga naar het tabje Billing plans. Hier dien je onder het kopje One Call API 3.0 het abonnement te activeren.
Merk op dat je, voordat je op Subscribe klikt, in de rij Base plan, onder Calls per day (no more than), eventueel de limiet kunt veranderen van 2.000 naar 1.000. Dit zorgt ervoor dat de API nooit meer dan 1.000 aanvragen zal accepteren. Dat is de vrije limiet. Daardoor zal niets in rekening worden gebracht. Klik na deze aanpassing op de knop Subscribe.
In de volgende stap worden je naam- en adresgegevens gevraagd. Vervolgens wordt gevraagd om creditcardgegevens. Er wordt niets in rekening gebracht, zolang je onder de vrije limiet van 1.000 aanvragen per dag blijft. Dat is in de praktijk ook meer dan toereikend. Hierboven geldt een tarief van €0,14 per 100 aanvragen. Maar als je dit hebt gelimiteerd op 1.000, zoals hierboven aangegeven, kom je dus nooit op het punt dat je moet gaan betalen.
Let op dat het tot twee uur kan duren voordat je abonnement is geactiveerd! Wacht daarom voor de zekerheid even met het maken van de aanpassingen in Home Assistant. De API-keys die je eerder hebt aangemaakt blijven overigens geldig. Je kunt, via je accountpagina, uiteraard wel nieuwe API-keys maken, als je dat wenst.
Aanpassingen Home Assistant
In Home Assistant is een kleine aanpassing nodig. De integratie is al aangepast voor API v.30 maar je moet expliciet aangeven dat het die nieuwe API moet gebruiken. Hiervoor ga je naar Instellingen / Apparaten & diensten en klik je op het tabblad Integraties op OpenWeatherMap. Open het menu (via de drie puntjes) en kies Configureren. Kies bij Modus de optie v3.0 en klik op Verzenden. Klik ten slotte op Voltooien.
Stappenplan nieuwe gebruikers
Wil je OpenWeatherMap gaan gebruiken met bijvoorbeeld Home Assistant, dan zul je eerst een account moeten maken op de website van de betreffende dienst (https://home.openweathermap.org/users/sign_up). Bevestig je e-mailadres via de link die je ontvangt. Log daarna in met je account. Rechtsboven kun je naar je profiel.
Je kunt de stappen zoals hierboven toegelicht volgen. Daarvoor begin je op het tabblad Billing plans waar je een abonnement kunt afsluiten, met eventueel een limiet van 1.000 aanvragen (om onder de betalingsdrempel te blijven). Onder API keys kun je vervolgens een API-sleutel maken. Die heb je nodig bij het configureren van de integratie voor bijvoorbeeld Home Assistant.
Integratie Home Assistant
In Home Assistant kun je de integratie toevoegen door naar Instellingen / Apparaten & diensten te gaan. Klik op Integratie toevoegen. Kies nu OpenWeatherMap. Vul de API-sleutel in. Controleer de waardes bij breedtegraad en lengtegraad, dat is de locatie waarop weersvoorspellingen worden gebaseerd. Kies bij Modus voor v3.0 en bij Taal de optie nl.
Sensoren
Als je de OpenWeatherMap-integratie opzoekt, zie je een lijst met sensoren die nuttige informatie verstrekken over het weer. Naast een uitgebreide weersverwachting kun je bijvoorbeeld de gevoelstemperatuur aflezen, de verwachte hoeveelheid regen en wind, de UV-index en de zichtbaarheid.
