Zum Hauptinhalt springen

Hong Kong Observatory Smart-Home-Integration, kostenlos und Open Source

Hong Kong Observatory-Integration für Gladys Assistant

Aktuelles Wetter, 9-Tage-Vorhersage, Regen-Kurzfrist und Warnsignale für Hongkong vom HKO.

Auf GitHub ansehenAlle Integrationen

Das Wetter von Hongkong in Gladys, vom Hong Kong Observatory (HKO, 香港天文台): die Temperatur der nächsten Wetterstation, die 9-Tage-Vorhersage, die Regen-Kurzfristvorhersage der nächsten Stunde und die geltenden Warnungen und Signale (Tropensturmsignale, Starkregenwarnungen, sehr heißes Wetter…). Offene Daten: kein Konto, kein API-Schlüssel.

Quelle: Hong Kong Observatory, offene Daten veröffentlicht über DATA.GOV.HK. Diese Integration ist ein Community-Projekt und nicht mit dem Hong Kong Observatory verbunden.

Was du bekommst​

  • Das Wetter-Widget von Gladys und der Assistent nutzen das Observatorium: die Temperatur der Station, die deinem Zuhause am nächsten liegt (27 Stationen, alle 10 Minuten aktualisiert), die am Observatorium gemessene Luftfeuchtigkeit, der UV-Index der letzten Stunde, das Symbol des aktuellen Wetters, Sonnenaufgang und Sonnenuntergang und die nächsten 8 Tage (Himmel, Tiefst- und Höchsttemperatur, Luftfeuchtigkeit, Wind, Wahrscheinlichkeit für ergiebigen Regen). Alles wird in °C und m/s oder in °F und mph angezeigt, je nach Einheitensystem jedes Benutzers von Gladys.
  • Die geltenden Warnungen und Signale, als Warnhinweise im Wetter-Widget: Tropensturmsignale Nr. 1 bis Nr. 10 und die Sondermeldung vor Signal Nr. 8, Starkregenwarnungen Bernstein, Rot und Schwarz, Gewitter, Überschwemmungen in den nördlichen New Territories, Erdrutsch, starker Monsun, sehr heißes Wetter, kaltes Wetter, Frost, Waldbrandgefahr und Tsunami. Der eingebaute Szenenauslöser Wetterwarnung von Gladys funktioniert damit und löst etwa zehn Minuten nach einer Änderung aus.
  • Szenenauslöser „Warnung in Hongkong geändert“: ein Signal ausgegeben, hochgestuft (Nr. 3 → Nr. 8, Bernstein → Rot), herabgestuft, aktualisiert oder aufgehoben, mit einem Satz in deiner Sprache.
  • Szenenauslöser „Regen in der nächsten Stunde erwartet“, nach der Regen-Kurzfristvorhersage des Observatoriums.
  • Szenenaktion „Regen der nächsten Stunde abrufen“.
  • Szenenaktion „Tagesvorhersage abrufen“ (heute oder morgen).
  • Szenenaktion „Warnungen in Hongkong abrufen“: die Nummer des Taifunsignals, die Farbe der Starkregenwarnung und die höchste Schwere, um eine Szene davon abhängig zu machen.

Kein zusätzliches Widget: Das Wetter-Widget von Gladys zeigt schon das aktuelle Wetter, die Vorhersage und die Warnungen.

Nur Hongkong. Für ein Zuhause anderswo antwortet die Integration „keine Vorhersage“, und Gladys nutzt den nächsten Wetteranbieter.

Installation​

  1. Prüfe, dass dein Zuhause in Gladys einen Standort hat: Einstellungen → Zuhause, dann die Adresse oder die Position auf der Karte.
  2. Installiere Hong Kong Observatory aus dem Integrations-Store (oder Integrationen → Von GitHub installieren mit der Adresse https://github.com/guim31/gladys-hko). Gladys bittet dich, den Zugriff auf den Standort deiner Zuhause zu erlauben: Die Integration wählt für jedes Zuhause die nächste Station und den nächsten Punkt der Kurzfristvorhersage und prüft, dass es in Hongkong liegt.
  3. Öffne den Tab Konfiguration und klicke auf Observatorium testen. Die Antwort zeigt die Temperatur der Station, die deinem Zuhause am nächsten liegt, und die geltenden Warnungen.

Das war’s: Das Wetter-Widget deines Dashboards zeigt jetzt das Observatorium. Ist eine andere Wetter-Integration installiert, wähle den Anbieter in den Einstellungen des Wetter-Widgets.

Gladys 5.2 oder neuer ist erforderlich.

Konfiguration​

Nichts ist Pflicht.

  • Einheiten der Szenenwerte — die Einheiten der Temperaturen, des Windes und des Regens, die die Integration in Szenenvariablen schreibt. Automatisch folgt dem Einheitensystem des letzten Benutzers, der das Wetter angesehen hat; wähle Metrisch oder US, um es festzulegen. Das Wetter-Widget folgt immer der Einstellung jedes Benutzers.
  • Sprache der Szenentexte — die Sprache der Sätze, die die Integration in Szenenvariablen schreibt („Ausgegeben: Sturmsignal Nr. 8 aus Nordost.“): Englisch, Französisch, Deutsch oder Spanisch. Standardmäßig Französisch; Automatisch folgt der Sprache deines Gladys. Die Texte des Observatoriums selbst (Vorhersagetext, Details der Warnungen) sind Englisch.

Aktualisierung und Bedingungen des Observatoriums​

Das Observatorium veröffentlicht diese Daten frei auf DATA.GOV.HK, ohne veröffentlichte Anfragegrenze. Die Integration bleibt sparsam:

  • ein Timer läuft alle 10 Minuten, plus bis zu 2 zufällige Minuten, damit nicht alle Gladys in derselben Sekunde anfragen;
  • der aktuelle Wetterbericht und die Warnungen werden alle 10 Minuten gelesen, die 9-Tage-Vorhersage und die lokale Vorhersage alle 30 Minuten (kleine JSON-Antworten, für alle Zuhause dieselben);
  • die Regen-Kurzfristvorhersage ist eine 2,7-MB-Datei für das Perlflussdelta, alle 30 Minuten heruntergeladen (etwa 130 MB pro Tag);
  • solange kein Zuhause in Gladys in Hongkong liegt, wird nichts abgefragt, und das Öffnen des Dashboards kostet nichts: Gladys wird aus dem Speicher bedient;
  • sie pausiert, wenn das Observatorium bittet, langsamer zu werden (Fehler 429), oder die Anfragen ablehnt (Fehler 403).

Bei einem Ausfall bleiben der letzte Bericht und die letzte Vorhersage höchstens 3 Stunden sichtbar.

Szenen​

Die Integration fügt ihre Karten dem Szeneneditor hinzu, in der Kategorie Integrationen. Das Feld Zuhause listet deine Zuhause; nur die Zuhause in Hongkong sind betroffen.

Warnung in Hongkong geändert​

Auslöser: startet die Szene, wenn eine Warnung oder ein Signal des Observatoriums ausgegeben, hochgestuft (Nr. 3 → Nr. 8, Bernstein → Rot…), herabgestuft, aktualisiert (Nr. 8 wechselt den Quadranten, neu ausgegeben, verlängert) oder aufgehoben wird. Er löst für jedes Zuhause in Hongkong aus, nie bei der ersten Abfrage nach einem Neustart und nie, wenn das Observatorium nicht erreichbar ist.

Optionale Filter (leer: alles passt):

  • Zuhause;
  • Änderung: ausgegeben, hochgestuft, herabgestuft, aktualisiert, aufgehoben;
  • Schwere: gering (Bereitschaftssignal Nr. 1), mäßig (Nr. 3, Sondermeldung vor Nr. 8, Starkregen Bernstein, Gewitter, sehr heiß, kalt, Frost, starker Monsun, Waldbrand Gelb), schwer (Nr. 8, Starkregen Rot, Erdrutsch, Überschwemmung, Waldbrand Rot), extrem (Nr. 9, Nr. 10, Starkregen Schwarz, Tsunami);
  • Phänomen: tropischer Wirbelsturm, Starkregen, Gewitter, Überschwemmung, Erdrutsch, starker Monsun, sehr heißes Wetter, kaltes Wetter, Frost, Waldbrandgefahr, Tsunami, andere.

Variablen für die folgenden Aktionen: das Zuhause, die Änderung (issued, upgraded, downgraded, updated, lifted), die Schwere (minor, moderate, severe, extreme), das Phänomen (tropical_cyclone, rainstorm…), der Signalcode des Observatoriums (TC8NE, WRAINR…), der Name des Signals in deiner Sprache, die Details des Observatoriums (Englisch) und eine Zusammenfassung zum Versenden, zum Beispiel: „Hochgestuft: Signal Nr. 9 für zunehmenden Sturm (vorher Sturmsignal Nr. 8 aus Nordost).“

Regen in der nächsten Stunde erwartet​

Auslöser: startet die Szene, wenn die Regen-Kurzfristvorhersage Regen am Zuhause in der nächsten Stunde zeigt, wo die vorherige Abfrage keinen zeigte. Er löst einmal pro Ereignis aus, höchstens einmal pro Stunde und Zuhause, und nie bei der ersten Abfrage nach einem Neustart.

Optionale Filter (leer: alles passt):

  • Zuhause;
  • Intensität: leicht (unter 2,5 mm/h), mäßig (bis 7,6 mm/h) oder stark.

Variablen für die folgenden Aktionen: der Name des Zuhauses, die Intensität (light, moderate, heavy), die Minuten bis zum Beginn (0, wenn es schon regnet), der in der nächsten Stunde erwartete Regen und eine Zusammenfassung zum Versenden, zum Beispiel: „Mäßiger Regen in 20 Minuten erwartet.“

Regen der nächsten Stunde abrufen​

Aktion: sagt der Szene, ob in der nächsten Stunde Regen kommt (Regen erwartet: ja oder nein), wann, wie stark, wie viel, und dieselbe Zusammenfassung. Lass Zuhause leer für dein erstes Zuhause mit Standort. Deckt die Kurzfristvorhersage die Stunde nicht ab (Zuhause außerhalb von Hongkong, Download fehlgeschlagen), ist Vorhersage verfügbar nein: Lies das nicht als „trocken“.

Tagesvorhersage abrufen​

Aktion: liest die Vorhersage für heute oder morgen und gibt zurück:

  • den Himmel, als Gladys-Code (clear, partly-cloudy, rain…) und in Worten („Regen“);
  • die Tiefst- und Höchsttemperatur und die Luftfeuchtigkeit;
  • die Wahrscheinlichkeit für ergiebigen Regen, wie das Observatorium sie angibt (low, medium_low, medium, medium_high, high), und in Prozent (die Mitte der Klasse: 15, 38, 50, 63 oder 85);
  • den Wind, aus dem Vorhersagetext gelesen;
  • den Vorhersagetext des Observatoriums (Englisch);
  • eine Zusammenfassung, zum Beispiel: „Morgen: Klarer Himmel, 25 bis 31 °C, geringe Wahrscheinlichkeit für ergiebigen Regen.“

Die 9-Tage-Vorhersage beginnt mit morgen, sobald die Morgenaktualisierung erschienen ist: heute gibt dann den aktuellen Himmel und den Vorhersagetext des Observatoriums für den Rest des Tages, ohne Temperaturen.

Warnungen in Hongkong abrufen​

Aktion: gibt zurück, ob mindestens eine Warnung gilt, wie viele, die höchste Schwere (none, minor, moderate, severe, extreme), das Tropensturmsignal (0, 1, 3, 8, 9 oder 10), das Starkregensignal (none, amber, red, black), Phänomen, Code und Name der höchsten und eine Zusammenfassung, zum Beispiel: „1 Warnung in Hongkong in Kraft: Waldbrandwarnung Rot.“ Ist das Observatorium nicht erreichbar, ist Warnungen verfügbar nein.

Szenenbeispiele​

  • Taifun im Anmarsch: Auslöser „Warnung in Hongkong geändert“, Phänomen tropischer Wirbelsturm, Änderung ausgegeben oder hochgestuft, Schwere schwer oder extrem, dann eine Benachrichtigung mit der Zusammenfassung, Rollläden zu und Balkonlicht aus.
  • Schwarzer Regen: Auslöser „Warnung in Hongkong geändert“, Phänomen Starkregen, Schwere extrem, dann eine Nachricht, zu Hause zu bleiben.
  • Wäsche reinholen: Auslöser „Regen in der nächsten Stunde erwartet“, dann eine Benachrichtigung mit der Variable Zusammenfassung.
  • Morgenwetter: um 7:00 Aktion „Tagesvorhersage abrufen“ (heute), dann „Warnungen in Hongkong abrufen“, dann eine Nachricht mit beiden Zusammenfassungen; kein Gartengießen, wenn das Starkregensignal nicht none ist.

Grenzen​

  • Ohne ein Gladys in Hongkong entwickelt: Die Integration ist mit echten Antworten des Observatoriums getestet (24. Oktober 2026, mit einer roten Waldbrandwarnung) und, für die Taifun- und Starkregensignale, mit dem dokumentierten Format der API. Rückmeldungen sind willkommen.
  • Nur Hongkong (siehe oben).
  • Keine stündliche Vorhersage: Die offenen Daten des Observatoriums haben keine, der 24-Stunden-Streifen des Wetter-Widgets bleibt also leer; die Tage kommen aus der 9-Tage-Vorhersage.
  • Die Station ist die nächste unter den 27 des aktuellen Berichts (die Gipfelstationen sind ausgeschlossen). Die Luftfeuchtigkeit ist die des Observatoriums, der UV-Index der von King’s Park.
  • Der aktuelle Himmel ist das Symbol des Observatoriums für das ganze Gebiet.
  • Warnungen für das ganze Gebiet: Das Observatorium gibt kein Gebiet an; jedes Zuhause in Hongkong erhält jede Warnung, auch die Überschwemmungsmeldung für die nördlichen New Territories.
  • Texte auf Englisch: Die Integration übersetzt die Signalnamen, den Himmel und die Änderung, nicht die Details und nicht den Vorhersagetext.
  • Die Regen-Kurzfristvorhersage hat ein 2-km-Raster und Halbstundenschritte; alle 30 Minuten gelesen, wird ein Schauer, der zwischen zwei Downloads beginnt, vom nächsten gemeldet.
  • Die Regenwahrscheinlichkeit ist eine Klasse; der an Gladys gegebene Prozentwert ist ihre Mitte.
  • Die Integration braucht Gladys 5.2 oder neuer.

Fehlerbehebung​

  • „Kein Zuhause in Gladys hat einen Standort“ — lege den Standort deines Zuhauses unter Einstellungen → Zuhause fest.
  • „Kein Zuhause in Gladys liegt in Hongkong“ — das Observatorium deckt nur Hongkong ab: Prüfe den Standort deines Zuhauses unter Einstellungen → Zuhause.
  • „Das Observatorium bittet darum, langsamer zu werden“ — zu viele Anfragen von deiner Internetverbindung: Die Integration wartet und versucht es selbst erneut.
  • „Das Observatorium lehnt die Anfragen ab (HTTP 403)“ — aktualisiere die Integration.
  • „Das Hong Kong Observatory ist im Moment nicht erreichbar“ — Gladys erreicht data.weather.gov.hk nicht: Prüfe seinen Internetzugang. Die Integration versucht es nach 5 Minuten erneut, dann immer seltener.
  • „Regen der nächsten Stunde abrufen“ meldet die Vorhersage als nicht verfügbar — der Download von 2,7 MB ist fehlgeschlagen oder hat zu lange gedauert (das Observatorium liefert ihn außerhalb von Hongkong langsam): Er wird bei der nächsten Aktualisierung, 10 Minuten später, erneut versucht.
  • Das Dashboard zeigt noch einen anderen Anbieter — öffne die Einstellungen des Wetter-Widgets und wähle Hong Kong Observatory.
  • Protokolle: Der Tab Protokolle der Integration (oder docker logs auf dem Host) zeigt den Start, jede Warnungsänderung, die Probleme und die Rückkehr des Observatoriums, jeweils einmal. Starte den Container mit LOG_LEVEL=debug, um jede Aktualisierung zu sehen.

Datenschutz​

Nichts über dich verlässt Gladys: Jede Anfrage fragt Daten ab, die für alle gleich sind (Bericht, Vorhersagen, Warnungen und Kurzfristvorhersage des Gebiets). Der Standort deiner Zuhause wird nur im Container genutzt, um die nächste Station und den nächsten Punkt der Kurzfristvorhersage zu wählen. Kein Konto, kein Schlüssel, nichts wird auf die Festplatte geschrieben.

Danksagung​

Aktuelles Wetter, Vorhersagen, Warnungen und Regen-Kurzfristvorhersage: Hong Kong Observatory (hko.gov.hk), offene Daten veröffentlicht über DATA.GOV.HK nach seinen Nutzungsbedingungen; die Daten werden in das Wetterformat von Gladys umgewandelt (Einheiten, Symbole, Tage, Warnhinweise). Das Vokabular der Symbole und Signale folgt der Dokumentation der offenen Daten-API des Observatoriums. Inspiriert von der Home-Assistant-Integration hko (Apache 2.0). Sonnenaufgang und Sonnenuntergang werden mit den Algorithmen des Sonnenrechners der NOAA berechnet.

Konfigurationseinstellungen​

Diese Einstellungen fragt Hong Kong Observatory in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Keine Anmeldung nötigsectionNeinOffene Daten des Hong Kong Observatory: kein Konto, kein API-Schlüssel. Jedes Zuhause in Gladys mit Standort in Hongkong erhält die Temperatur der nächsten Station, die 9-Tage-Vorhersage, die Regen-Kurzfristvorhersage und die geltenden Warnsignale. Nur Hongkong: anderswo nutzt Gladys den nächsten Wetteranbieter. Quelle: Hong Kong Observatory (DATA.GOV.HK). Nicht mit dem Observatorium verbunden.
Einheiten der SzenenwerteselectNeinEinheiten der Temperaturen, des Windes und des Regens, die die Integration in Szenenvariablen schreibt. Das Wetter-Widget folgt immer der Einstellung jedes Benutzers.
Sprache der SzenentexteselectNeinSprache der Sätze, die die Integration in Szenenvariablen schreibt. Automatisch folgt der Sprache deines Gladys.

So installierst du Hong Kong Observatory in Gladys​

  1. Öffne in Gladys Integrationen: Hong Kong Observatory erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-hko:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-hko.

Hong Kong Observatory 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​

Hong Kong Observatory 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am