KNMI Smart-Home-Integration, kostenlos und Open Source
Offizielles niederländisches Wetter (KNMI über Weerlive): Messwerte, Vorhersagen, Warnungen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Das offizielle Wetter der Niederlande in Gladys: Messwerte, Vorhersagen und Warnungen des KNMI (Koninklijk Nederlands Meteorologisch Instituut, der niederländische Wetterdienst), gelesen über die kostenlose API von Weerlive.nl. Gedacht für Niederländer in Frankreich, für Menschen nahe der belgisch-niederländischen Grenze und für alle mit einem Haus in den Niederlanden.
Ohne Weerlive-Konto entwickelt: Rückmeldungen willkommen. Die Integration wurde mit echten Antworten von Weerlive (veröffentlicht von den Projekten python-weerlive und ha-knmi) gebaut und getestet, nicht mit dem echten Dienst. Melde, was funktioniert und was nicht, in den Issues.
Diese Integration hat keine Verbindung zu KNMI oder Weerlive.
Überblick
- Ein Gerät pro Ort: ein Gladys-Haus (sein Standort), niederländische Orte oder Koordinaten, höchstens fünf Orte.
- Jedes Gerät zeigt Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Luftdruck, Wind (Beaufort, km/h und Richtung), Sichtweite, den Niederschlag der kommenden Stunde, die Wetterlage, Sonnenaufgang und Sonnenuntergang sowie die KNMI-Warnung: ihre Farbe (Grün, Gelb, Orange, Rot), ihren Titel und Text und die nächste angekündigte Warnung.
- Ein Szenen-Auslöser Neue KNMI-Warnung, mit dem KNMI-Text bereit für eine Benachrichtigung.
- Ein Dashboard-Widget KNMI-Vorhersage: Live-Werte, Warnungen, Sonne und 5-Tage-Vorhersage.
- Nur lesend: Nichts lässt sich steuern.
Voraussetzungen
- Gladys Assistant 5.2.0 oder neuer (Hausauswahl in der Konfiguration, Widgets, Szenen-Auslöser).
- Ein kostenloser Weerlive-API-Schlüssel: Fülle das Formular auf weerlive.nl/delen.php mit deiner E-Mail-Adresse aus; der Schlüssel kommt per E-Mail. Weerlive behält den kostenlosen Schlüssel der privaten Nutzung und dem Hobby vor.
- Internetzugang für Gladys (die Integration ruft
weerlive.nlauf). - Der Installationsbildschirm fragt nach dem Zugriff auf den Standort deiner Häuser: Er dient nur dem Haus, das du in der Konfiguration wählst.
Konfiguration
Öffne Integrationen → KNMI → Konfiguration.
Weerlive-API-Schlüssel
Füge den per E-Mail erhaltenen Schlüssel ein. Er bleibt in der Konfiguration von Gladys, nie in den Protokollen.
Orte
- Gladys-Haus: das Wetter am Standort dieses Hauses verfolgen (festgelegt unter Einstellungen → Häuser). Die Koordinaten werden auf zwei Nachkommastellen gerundet an Weerlive gesendet, etwa 1 km.
- Weitere Orte: niederländische Orte (
Amsterdam,'s-Hertogenbosch) oder Koordinaten (52.09,5.12), durch Semikolons getrennt. Weerlive nimmt die nächstgelegene Station: Die Schaltfläche Verbindung testen sagt dir, welchen Ort es gefunden hat. - Höchstens fünf Orte, Haus inklusive.
Öffne dann den Reiter Erkennung und füge die gewünschten Geräte hinzu: Nur hinzugefügte Geräte werden gelesen.
Aktualisierung und Kontingent
Der kostenlose Schlüssel erlaubt 300 Anfragen pro Tag, und Weerlive aktualisiert seine Daten
alle 10 Minuten. Die Integration liest jeden hinzugefügten Ort höchstens alle 10 Minuten (Feld
Aktualisierungsintervall) und verlangsamt sich bei mehreren Orten von selbst, damit alle zusammen
unter 240 Anfragen pro Tag bleiben: 12 Minuten mit zwei Orten, 18 mit drei, 30 mit fünf. Die letzte
Messung wird in /data gespeichert: Ein Neustart von Gladys verbraucht das Kontingent nicht erneut,
und die Anzeige des Widgets stellt nie eine Anfrage.
Sprache
Sprache der Texte (standardmäßig Französisch) benennt die Funktionen neuer Geräte und schreibt Wetterlage und Daten. Die Funktionsnamen werden beim Hinzufügen eines Geräts festgelegt. Die Warntexte des KNMI bleiben auf Niederländisch, so wie das KNMI sie schreibt.
Geräte
Alle Funktionen sind nur lesend.
| Funktion | Wert |
|---|---|
| Temperatur, gefühlte Temperatur | °C |
| Luftfeuchtigkeit | % |
| Luftdruck | hPa |
| Wind (Beaufort) | 0 bis 12 |
| Windgeschwindigkeit | km/h |
| Windrichtung | Grad (0 = aus Norden, 90 = aus Osten) |
| Sichtweite | km |
| Niederschlag, kommende Stunde | vorhergesagte mm für die laufende Stunde |
| Wetterlage | sonnig, bewölkt, Schauer… in der gewählten Sprache |
| Sonnenaufgang, Sonnenuntergang | Ortszeit der Niederlande (wie in Frankreich und Belgien) |
| KNMI-Warnstufe | 0 Grün, 1 Gelb, 2 Orange, 3 Rot |
| KNMI-Warnung, Text | Titel und Text des KNMI, auf Niederländisch |
| Wetteralarm | 1, wenn Weerlive einen Wetteralarm für die Region meldet |
| Stufe der nächsten Warnung | Farbe der nächsten angekündigten Warnung (0, wenn keine) |
| Nächste KNMI-Warnung ab | ihr Beginn, oder „Keine“ |
Widget
Füge das Widget KNMI-Vorhersage zu einem Dashboard hinzu und wähle einen Ort. Es zeigt den Ort und die Wetterlage, drei Live-Kacheln (Temperatur, gefühlt, Wind), die 5-Tage-Vorhersage (Minimum und Maximum, Regenwahrscheinlichkeit, Wind), die gültige und die nächste Warnung mit ihren Farben, Sonnenaufgang und Sonnenuntergang und den niederländischen KNMI-Text, wenn eine Warnung gilt. Es wird aus der letzten Messung gebaut: Es kostet keine Anfrage.
Szenen-Auslöser
Neue KNMI-Warnung löst einmal pro neuer Warnung aus:
- Jetzt gültig: Eine gelbe, orange oder rote Warnung beginnt für den Ort, oder eine andere Warnung ersetzt sie;
- Für später angekündigt: Das KNMI kündigt eine später beginnende Warnung an, wenn diese Farbe und dieser Beginn zum ersten Mal gesehen werden.
Filter: der Ort, die Farben, wann. Variablen für die Aktionen: place, level (yellow,
orange, red), level_number (1 bis 3), phase (current, upcoming), title und text
(auf Niederländisch, für eine gültige Warnung), starts_at (ISO-Datum). Die erste Messung nach der
Installation notiert nur, was gilt, und ein Neustart löst dieselbe Warnung nie zweimal aus. Das
Ende einer Warnung ist kein Ereignis: Nutze die Funktion KNMI-Warnstufe (= 0).
Konfigurationsaktion
Verbindung testen liest den ersten Ort einmal (eine Anfrage des Kontingents) und sagt dir, ob der Schlüssel akzeptiert wird, welchen Ort Weerlive gefunden hat, wie viele Anfragen heute noch bleiben und in welchem Takt gelesen wird.
Szenenbeispiele
- Sturmwarnung: Auslöser Neue KNMI-Warnung, Farben Orange und Rot, Jetzt gültig → eine Nachricht „KNMI-Warnung {{triggerEvent.data.level}}: {{triggerEvent.data.title}}“ senden.
- Markise einfahren: Auslöser Gerätezustand auf Wind (Beaufort) deines Hauses, ≥ 6 → die Markise oder die Rollläden schließen.
- Am Vorabend: Auslöser Neue KNMI-Warnung, Für später angekündigt → eine Benachrichtigung
mit
starts_at, um die Gartenmöbel hereinzuholen.
Fehlerbehebung
- „Weerlive hat den API-Schlüssel abgelehnt“: Prüfe den per E-Mail erhaltenen Schlüssel, ohne Leerzeichen.
- „Tageslimit von Weerlive erreicht“: Die Messungen gehen nach Mitternacht (niederländische Zeit) weiter. Weniger Orte oder ein längeres Intervall helfen; auch die Schaltfläche Testen verbraucht eine Anfrage.
- „Weerlive antwortet nicht“: Ausfall des Dienstes oder des Internetzugangs von Gladys. Die Messungen gehen von selbst weiter.
- Kein Wert an einem Gerät: Prüfe, ob das Gerät im Reiter Erkennung hinzugefügt wurde.
- Seltsamer Ort: Weerlive nimmt die nächstgelegene Station; gib einen anderen Ort oder Koordinaten ein.
- Mehr Details: Setze
LOG_LEVEL=debugfür den Container und lies seine Protokolle.
Grenzen
- Die Daten decken die Niederlande ab: Ein weit entfernter Ort bekommt die nächstgelegene niederländische Station oder nichts.
- Die Warntexte sind auf Niederländisch, so wie das KNMI sie veröffentlicht.
- Höchstens fünf Orte pro Schlüssel und bestenfalls eine Messung alle 10 Minuten.
- Laut Weerlive ist der kostenlose Schlüssel für private Nutzung und Hobby gedacht.
- Ohne Weerlive-Konto entwickelt, mit echten veröffentlichten Antworten getestet.
Konfigurationseinstellungen
Diese Einstellungen fragt KNMI in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Das Wetter kommt vom KNMI über die API von Weerlive.nl. Beantrage auf weerlive.nl einen kostenlosen API-Schlüssel (eine E-Mail-Adresse genügt): Er erlaubt 300 Anfragen pro Tag, daher wird jeder Ort höchstens alle 10 Minuten gelesen, bei mehreren Orten seltener. Keine Verbindung zu KNMI oder Weerlive. |
| Weerlive-API-Schlüssel | secret | Ja | Der Schlüssel, den du per E-Mail von weerlive.nl bekommen hast. |
| Gladys-Haus | select | Nein | Das Wetter am Standort dieses Hauses verfolgen (an Weerlive auf etwa 1 km gerundet gesendet). |
| Weitere Orte | string | Nein | Niederländische Orte oder „Breitengrad,Längengrad“, durch Semikolons getrennt. Höchstens fünf Orte, Haus inklusive. |
| Aktualisierungsintervall | select | Nein | Wird bei mehreren Orten automatisch verlangsamt, um unter 300 Anfragen pro Tag zu bleiben. |
| Sprache der Texte | select | Nein | Funktionsnamen neuer Geräte, Wetterlage und Daten. Die Warntexte des KNMI bleiben auf Niederländisch. |
So installierst du KNMI in Gladys
- Öffne in Gladys Integrationen: KNMI erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-knmi:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-knmi.
KNMI benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
KNMI ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation