Intégration domotique Hong Kong Observatory, gratuite et open source

Météo actuelle, prévisions à 9 jours, pluie imminente et signaux d’alerte pour Hong Kong.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.2.0
• ★ 0

Voir sur GitHubToutes les intégrations

La météo de Hong Kong dans Gladys, par l’Observatoire de Hong Kong (Hong Kong Observatory, HKO, 香港天文台) : la température de la station météo la plus proche, la prévision à 9 jours, la prévision immédiate de pluie de l’heure à venir et les avertissements et signaux en vigueur (signaux de cyclone tropical, alertes pluies diluviennes, très fortes chaleurs…). Données ouvertes : ni compte, ni clé d’API.

Source : Hong Kong Observatory, données ouvertes publiées sur DATA.GOV.HK. Cette intégration est un projet communautaire, non affilié à l’Observatoire de Hong Kong.

Ce que vous obtenez

• Le widget météo de Gladys et l’assistant utilisent l’Observatoire : la température mesurée par la station la plus proche de votre maison (27 stations, mises à jour toutes les 10 minutes), l’humidité mesurée à l’Observatoire, l’indice UV de l’heure écoulée, l’icône du temps actuel, le lever et le coucher du soleil, et les 8 jours suivants (ciel, températures minimale et maximale, humidité, vent, probabilité de pluie significative). Tout s’affiche en °C et m/s ou en °F et mph, selon le système d’unités de chaque utilisateur de Gladys.
• Les avertissements et signaux en vigueur, en alertes sur le widget météo : signaux de cyclone tropical n° 1 à n° 10 et annonce avant le n° 8, alertes pluies diluviennes ambre, rouge et noire, orages, inondations dans le nord des Nouveaux Territoires, glissements de terrain, mousson forte, très fortes chaleurs, temps froid, gel, risque d’incendie et tsunami. Le déclencheur de scène alerte météo intégré à Gladys fonctionne avec eux, et se déclenche une dizaine de minutes après un changement.
• Déclencheur de scène « Avertissement de Hong Kong modifié » : un signal émis, relevé (n° 3 → n° 8, ambre → rouge), abaissé, mis à jour ou levé, avec une phrase dans votre langue.
• Déclencheur de scène « Pluie attendue dans l’heure », d’après la prévision immédiate de pluie de l’Observatoire.
• Action de scène « Obtenir la pluie de l’heure à venir ».
• Action de scène « Obtenir la prévision du jour » (aujourd’hui ou demain).
• Action de scène « Obtenir les avertissements de Hong Kong » : le numéro du signal de typhon, la couleur de l’alerte pluies et la gravité la plus haute, pour conditionner une scène.

Pas de widget en plus : le widget météo de Gladys affiche déjà le temps actuel, la prévision et les avertissements.

Hong Kong seulement. Pour une maison ailleurs, l’intégration répond « pas de prévision » et Gladys passe à son fournisseur météo suivant.

Installation

1. Vérifiez que votre maison a une position dans Gladys : Paramètres → Maisons, puis l’adresse ou la position sur la carte.
2. Installez Hong Kong Observatory depuis le store des intégrations (ou Intégrations → Installer depuis GitHub avec l’adresse https://github.com/guim31/gladys-hko). Gladys vous demande d’autoriser l’accès à la position de vos maisons : l’intégration choisit la station et le point de prévision immédiate les plus proches de chaque maison, et vérifie qu’elle est à Hong Kong.
3. Ouvrez l’onglet Configuration et cliquez sur Tester l’Observatoire. La réponse affiche la température de la station la plus proche de votre maison et les avertissements en vigueur.

C’est tout : le widget météo de votre tableau de bord affiche maintenant l’Observatoire. Si une autre intégration météo est installée, choisissez le fournisseur dans les réglages du widget météo.

Gladys 5.2 ou plus récent est nécessaire.

Configuration

Rien n’est obligatoire.

• Unités des valeurs de scène — les unités des températures, du vent et de la pluie que l’intégration met dans les variables de scène. Automatique suit le système d’unités du dernier utilisateur qui a consulté la météo ; choisissez Métrique ou US pour le fixer. Le widget météo suit toujours la préférence de chaque utilisateur.
• Langue des textes de scène — la langue des phrases que l’intégration met dans les variables de scène (« Émission : Signal n° 8 de coup de vent ou tempête du nord-est. ») : anglais, français, allemand ou espagnol. Français par défaut ; Automatique suit la langue de votre Gladys. Les textes de l’Observatoire lui-même (texte de la prévision, détails des avertissements) sont en anglais.

Fréquence de mise à jour et conditions de l’Observatoire

L’Observatoire publie ces données librement sur DATA.GOV.HK, sans limite de requêtes publiée. L’intégration reste légère :

• un minuteur tourne toutes les 10 minutes, plus jusqu’à 2 minutes au hasard pour que tous les Gladys n’appellent pas à la même seconde ;
• le bulletin météo actuel et les avertissements sont lus toutes les 10 minutes, la prévision à 9 jours et la prévision locale toutes les 30 minutes (petites réponses JSON, les mêmes pour toutes les maisons) ;
• la prévision immédiate de pluie est un fichier de 2,7 Mo couvrant le delta de la rivière des Perles, téléchargé toutes les 30 minutes (environ 130 Mo par jour) ;
• rien n’est appelé tant qu’aucune maison de Gladys n’est à Hong Kong, et ouvrir le tableau de bord ne coûte rien : Gladys est servi depuis la mémoire ;
• elle fait une pause si l’Observatoire demande de ralentir (erreur 429) ou refuse les requêtes (erreur 403).

Pendant une panne, le dernier bulletin et la dernière prévision restent visibles 3 heures au plus.

Scènes

L’intégration ajoute ses cartes à l’éditeur de scènes, dans la catégorie Intégrations. Le champ Maison liste vos maisons ; seules les maisons situées à Hong Kong sont concernées.

Avertissement de Hong Kong modifié

Déclencheur : lance la scène quand un avertissement ou un signal de l’Observatoire est émis, relevé (n° 3 → n° 8, ambre → rouge…), abaissé, mis à jour (n° 8 qui change de quadrant, réémis, prolongé) ou levé. Il se déclenche pour chaque maison à Hong Kong, jamais à la première lecture après un redémarrage, ni quand l’Observatoire est injoignable.

Filtres facultatifs (vides : tout correspond) :

• Maison ;
• Changement : émis, relevé, abaissé, mis à jour, levé ;
• Gravité : mineure (signal d’alerte n° 1), modérée (n° 3, annonce avant le n° 8, alerte pluies ambre, orages, très fortes chaleurs, froid, gel, mousson forte, risque d’incendie jaune), sévère (n° 8, alerte pluies rouge, glissements de terrain, inondations, risque d’incendie rouge), extrême (n° 9, n° 10, alerte pluies noire, tsunami) ;
• Phénomène : cyclone tropical, pluies diluviennes, orages, inondations, glissements de terrain, mousson forte, très fortes chaleurs, temps froid, gel, risque d’incendie, tsunami, autre.

Variables pour les actions suivantes : la maison, le changement (issued, upgraded, downgraded, updated, lifted), la gravité (minor, moderate, severe, extreme), le phénomène (tropical_cyclone, rainstorm…), le code du signal de l’Observatoire (TC8NE, WRAINR…), le nom du signal dans votre langue, les détails de l’Observatoire (en anglais), et un résumé prêt à envoyer, par exemple : « Hausse : Signal n° 9 de coup de vent ou tempête en renforcement (au lieu de Signal n° 8 de coup de vent ou tempête du nord-est). »

Pluie attendue dans l’heure

Déclencheur : lance la scène quand la prévision immédiate de pluie annonce de la pluie sur la maison dans l’heure à venir, là où la lecture précédente n’en annonçait pas. Il se déclenche une fois par épisode, au plus une fois par heure et par maison, et jamais à la première lecture après un redémarrage.

Filtres facultatifs (vides : tout correspond) :

• Maison ;
• Intensité : faible (moins de 2,5 mm/h), modérée (jusqu’à 7,6 mm/h) ou forte.

Variables pour les actions suivantes : le nom de la maison, l’intensité (light, moderate, heavy), les minutes avant le début (0 s’il pleut déjà), la pluie attendue dans l’heure, et un résumé prêt à envoyer, par exemple : « Pluie modérée attendue dans 20 minutes. »

Obtenir la pluie de l’heure à venir

Action : dit à la scène si la pluie arrive dans l’heure (Pluie attendue : oui ou non), quand, avec quelle intensité, en quelle quantité, et le même résumé. Laissez Maison vide pour votre première maison qui a une position. Si la prévision immédiate ne couvre pas l’heure (maison hors de Hong Kong, téléchargement échoué), Prévision disponible vaut non : ne le lisez pas comme « sec ».

Obtenir la prévision du jour

Action : lit la prévision d’aujourd’hui ou de demain et renvoie :

• le ciel, en code Gladys (clear, partly-cloudy, rain…) et en toutes lettres (« Pluie ») ;
• les températures minimale et maximale, et l’humidité ;
• la probabilité de pluie significative telle que l’Observatoire la donne (low, medium_low, medium, medium_high, high) et en pourcentage (le milieu de la classe : 15, 38, 50, 63 ou 85) ;
• le vent, lu dans le texte de la prévision ;
• le texte de la prévision de l’Observatoire (en anglais) ;
• un résumé, par exemple : « Demain : ciel dégagé, 25 à 31 °C, probabilité faible de pluie significative. »

La prévision à 9 jours commence au lendemain une fois la mise à jour du matin publiée : aujourd’hui donne alors le ciel actuel et le texte de la prévision de l’Observatoire pour le reste de la journée, sans températures.

Obtenir les avertissements de Hong Kong

Action : renvoie s’il y a au moins un avertissement en vigueur, combien, la gravité la plus haute (none, minor, moderate, severe, extreme), le signal de cyclone tropical (0, 1, 3, 8, 9 ou 10), le signal de pluies (none, amber, red, black), le phénomène, le code et le nom du plus haut, et un résumé, par exemple : « 1 avertissement en vigueur à Hong Kong : Risque d’incendie rouge. » Si l’Observatoire est injoignable, Avertissements disponibles vaut non.

Exemples de scènes

• Typhon en approche : déclencheur « Avertissement de Hong Kong modifié », phénomène cyclone tropical, changement émis ou relevé, gravité sévère ou extrême, puis une notification avec le résumé, les volets fermés et les lumières du balcon éteintes.
• Pluie noire : déclencheur « Avertissement de Hong Kong modifié », phénomène pluies diluviennes, gravité extrême, puis un message pour rester à la maison.
• Rentrer le linge : déclencheur « Pluie attendue dans l’heure », puis une notification avec la variable résumé.
• Météo du matin : à 7 h, action « Obtenir la prévision du jour » (aujourd’hui), puis « Obtenir les avertissements de Hong Kong », puis un message avec les deux résumés ; pas d’arrosage du jardin si le signal de pluies n’est pas none.

Limites

• Développée sans Gladys installé à Hong Kong : l’intégration est testée sur de vraies réponses de l’Observatoire (24 octobre 2026, avec une alerte risque d’incendie rouge en vigueur) et, pour les signaux de typhon et de pluies, sur le format documenté de l’API. Vos retours sont les bienvenus.
• Hong Kong seulement (voir plus haut).
• Pas de prévision horaire : les données ouvertes de l’Observatoire n’en ont pas, la bande des 24 heures du widget météo reste donc vide ; les jours viennent de la prévision à 9 jours.
• La station est la plus proche parmi les 27 du bulletin actuel (les stations de sommet sont écartées). L’humidité est celle de l’Observatoire, l’indice UV celui de King’s Park.
• Le ciel actuel est l’icône de l’Observatoire pour tout le territoire.
• Avertissements pour tout le territoire : l’Observatoire ne donne pas de zone ; chaque maison à Hong Kong reçoit chaque avertissement, y compris l’annonce d’inondations dans le nord des Nouveaux Territoires.
• Textes en anglais : l’intégration traduit les noms des signaux, le ciel et le changement, pas les détails ni le texte de la prévision.
• La prévision immédiate de pluie a une maille de 2 km et des pas d’une demi-heure ; lue toutes les 30 minutes, une averse qui commence entre deux téléchargements est annoncée par le suivant.
• La probabilité de pluie est une classe ; le pourcentage donné à Gladys en est le milieu.
• L’intégration nécessite Gladys 5.2 ou plus récent.

Dépannage

• « Aucune maison de Gladys n’a de position » — renseignez la position de votre maison dans Paramètres → Maisons.
• « Aucune maison de Gladys n’est à Hong Kong » — l’Observatoire ne couvre que Hong Kong : vérifiez la position de votre maison dans Paramètres → Maisons.
• « L’Observatoire demande de ralentir » — trop de requêtes depuis votre connexion Internet : l’intégration attend et réessaie d’elle-même.
• « L’Observatoire refuse les requêtes (HTTP 403) » — mettez à jour l’intégration.
• « L’Observatoire de Hong Kong est injoignable pour le moment » — Gladys n’atteint pas data.weather.gov.hk : vérifiez son accès à Internet. L’intégration réessaie après 5 minutes, puis de moins en moins souvent.
• « Obtenir la pluie de l’heure à venir » dit la prévision indisponible — le téléchargement de 2,7 Mo a échoué ou a pris trop de temps (l’Observatoire le sert lentement hors de Hong Kong) : il est retenté à la mise à jour suivante, 10 minutes plus tard.
• Le tableau de bord affiche encore un autre fournisseur — ouvrez les réglages du widget météo et choisissez Hong Kong Observatory.
• Journaux : l’onglet Journaux de l’intégration (ou docker logs sur l’hôte) montre le démarrage, chaque changement d’avertissement, les problèmes et le retour de l’Observatoire, une fois chacun. Démarrez le conteneur avec LOG_LEVEL=debug pour voir chaque mise à jour.

Confidentialité

Rien de ce qui vous concerne ne sort de Gladys : chaque requête demande des données identiques pour tous (bulletin, prévisions, avertissements et prévision immédiate du territoire). La position de vos maisons ne sert que dans le conteneur, pour choisir la station et le point de prévision immédiate les plus proches. Ni compte, ni clé, rien n’est écrit sur le disque.

Crédits

Temps actuel, prévisions, avertissements et prévision immédiate de pluie : Hong Kong Observatory (hko.gov.hk), données ouvertes publiées sur DATA.GOV.HK selon ses conditions d’utilisation ; les données sont converties au format météo de Gladys (unités, icônes, jours, alertes). Le vocabulaire des icônes et des signaux suit la documentation de l’API de données ouvertes de l’Observatoire. Inspirée de l’intégration Home Assistant hko (Apache 2.0). Le lever et le coucher du soleil sont calculés avec les algorithmes du calculateur solaire de la NOAA.

Paramètres de configuration

Voici les paramètres demandés par Hong Kong Observatory dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Aucune inscription	section	Non	Données ouvertes de l’Observatoire de Hong Kong : ni compte, ni clé d’API. Chaque maison située à Hong Kong reçoit la température de la station la plus proche, la prévision à 9 jours, la pluie imminente et les signaux d’alerte en vigueur. Ailleurs, Gladys passe à son fournisseur météo suivant. Source : Hong Kong Observatory (DATA.GOV.HK). Non affiliée à l’Observatoire.
Unités des valeurs de scène	select	Non	Unités des températures, du vent et de la pluie que l’intégration met dans les variables de scène. Le widget météo suit toujours la préférence de chaque utilisateur.
Langue des textes de scène	select	Non	Langue des phrases que l'intégration met dans les variables de scène. Automatique suit la langue de votre Gladys.

Comment installer Hong Kong Observatory dans Gladys

1. Dans Gladys, ouvrez Intégrations : Hong Kong Observatory apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-hko:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-hko.

Hong Kong Observatory nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Hong Kong Observatory est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂