Intégration domotique Environment Agency Flood, gratuite et open source

Hauteurs des rivières et alertes crues en Angleterre, par l'Environment Agency.

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

Voir sur GitHubToutes les intégrations

Apporte dans Gladys les hauteurs d'eau des rivières, des marées et des nappes d'Angleterre (environ 4 000 stations : la Tamise, la Severn, la Trent, la côte…) et les alertes crues en cours autour de votre maison, depuis l'API de surveillance des crues en temps réel de l'Environment Agency. Sans compte ni clé.

Ce n'est pas un service d'alerte crues. Les données peuvent être en retard, manquantes ou fausses, et l'intégration dépend de votre Gladys, de votre accès à Internet et d'un service public. En cas de crue, suivez les alertes officielles : inscrivez-vous aux alertes gratuites de l'Environment Agency, consultez Check for flooding ou appelez Floodline au 0345 988 1188 ; appelez le 999 si des vies sont en danger. Cette intégration est non affiliée à l'Environment Agency.

Ce que vous obtenez

• Un appareil par station suivie : la hauteur d'eau en mètres, son état par rapport à la plage habituelle de la station (faible, normal, élevé), le plus haut niveau récent, le débit en m³/s quand la station le mesure, et la date de la dernière mesure.
• Un appareil « Alertes crues » pour la zone autour de votre maison : le niveau de l'alerte la plus grave en cours (aucune, vigilance crue, alerte crue, alerte crue grave), le nombre d'alertes en cours et la dernière, en texte.
• Une station qui n'envoie plus rien est signalée (« Pas de nouvelle mesure depuis… ») : une ancienne valeur n'est jamais renvoyée comme si elle était fraîche.
• Quatre déclencheurs de scène : une alerte crue est émise ou aggravée, une alerte crue est levée, l'état d'une station change (faible, normal, élevé), un niveau de référence est franchi (plage habituelle, plus haut niveau récent, record).
• Un widget de tableau de bord : les alertes en cours autour de votre maison, puis vos stations, leur hauteur, sa tendance (monte, stable, baisse) et leur état.
• Un bouton « Chercher des stations » qui liste les stations autour de votre maison, par nom, cours d'eau ou ville, ou par référence, avec leur hauteur actuelle.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Un accès à Internet depuis Gladys : l'intégration lit environment.data.gov.uk.
• Pour les alertes crues et « Stations autour de ma maison » : la position de votre maison dans Gladys (Paramètres, Maisons). L'intégration la demande à l'installation (permission « position »). Elle ne sert que dans le conteneur, pour choisir les stations et zones les plus proches : jamais envoyée à l'Environment Agency, jamais stockée ni journalisée.
• Angleterre seulement : le pays de Galles, l'Écosse et l'Irlande du Nord ont leurs propres services.

Configuration

Réglages

Réglage	Effet
Stations	Références ou noms de stations, séparés par des virgules : 3400TH, Bewdley, E71539. L'adresse d'une page de station de « Check for flooding » fonctionne aussi.
Stations autour de ma maison	Suit aussi les 3 stations les plus proches qui envoient des mesures, à 10, 20 ou 50 km de votre maison au plus.
Alertes crues autour de ma maison	Crée l'appareil « Alertes crues », pour les zones inondables dont le centre est à 5, 10 (par défaut), 20 ou 50 km de votre maison. « Non » le retire des appareils découverts.
Fréquence de mise à jour	15, 20 ou 30 minutes. Une requête couvre toutes les stations, une autre les alertes.
Langue des noms de fonctionnalités	Noms des fonctionnalités des nouveaux appareils (Hauteur d'eau, Débit…), et langue des textes (« Dernière mesure », « Dernière alerte ») et des variables de scène.

Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et créez les appareils voulus. Une station suivie le reste tant que son appareil existe, même si vous la retirez de la configuration.

Trouver vos stations

Cliquez sur « Chercher des stations » dans la configuration. Laissez le champ vide pour lister les stations autour de votre maison (10 km, ou la distance choisie), ou tapez :

• un nom de station : Kingston, Bewdley (casse et accents ignorés) ;
• un cours d'eau ou une ville : Severn, Shrewsbury (les 10 plus proches, ou les 10 premières par cours d'eau) ;
• les deux : Thames Windsor ;
• une référence de station : 3400TH, ou l'adresse de sa page « Check for flooding ».

Chaque ligne donne la référence, le nom, le cours d'eau et la ville, la distance à votre maison et la hauteur actuelle, ou « pas de mesure récente ». Copiez les références dans « Stations », puis enregistrez.

Appareils

Stations

Fonctionnalité	Type dans Gladys	Valeur
Hauteur d'eau	Profondeur liquide (m)	La hauteur de la station, en mètres (voir ci-dessous).
État du niveau d'eau (plage habituelle)	État du niveau liquide	Faible sous la plage habituelle de la station, Élevé au-dessus, Normal dedans.
Plus haut niveau récent	Profondeur liquide (m)	Le plus haut niveau des dernières années, un repère pour le graphique d'historique.
Débit (m³/s)	Débit d'eau	En m³/s (Gladys n'a pas d'unité m³/s : le nom le dit), quand la station le mesure.
Dernière mesure	Texte	Date de la dernière mesure, ou « Pas de nouvelle mesure depuis… ».

Une fonctionnalité n'existe que si la station la fournit. La hauteur d'eau n'est pas une profondeur : pour une rivière, c'est la cote au-dessus du zéro de l'échelle de la station (mASD) ; pour les stations de marée et de nappe, un niveau au-dessus du niveau de la mer (mAOD, Ordnance Datum) : le paramètre LEVEL_DATUM de l'appareil le précise. Comparez-la à la plage habituelle de la même station (visible sur sa page « Check for flooding »), pas à une autre station. Les paramètres de l'appareil donnent la référence de la station, son identifiant RLOI (le numéro de sa page « Check for flooding »), son cours d'eau et sa ville.

La hauteur et le débit sont des fonctionnalités numériques : les scènes de Gladys savent déjà les comparer à une valeur de votre choix (« Hauteur d'eau au-dessus de 4,8 m »).

Alertes crues

Fonctionnalité	Type dans Gladys	Valeur
Niveau d'alerte crues	Niveau de risque	0 aucune, 1 vigilance crue, 2 alerte crue, 3 alerte crue grave : la plus grave en cours.
Alertes en cours	Compteur	Les vigilances et alertes en cours autour de votre maison.
Dernière alerte	Texte	« Alerte crue : Lyme Brook at Newcastle under Lyme (23/10 13:41) », ou aucune en cours.

L'Environment Agency émet trois niveaux : flood alert, ici « vigilance crue » (une inondation est possible, préparez-vous), flood warning, « alerte crue » (une inondation est attendue, agissez) et severe flood warning, « alerte crue grave » (danger de mort). Une alerte est « autour de votre maison » quand le centre de sa zone inondable est à la distance choisie : une grande zone peut couvrir votre maison avec un centre plus éloigné, choisissez 20 km en cas de doute.

Widget de tableau de bord

Ajoutez le widget Crues en Angleterre à un tableau de bord.

• Sans réglage : un titre avec l'alerte la plus grave en cours, une ligne par alerte autour de votre maison (4 au plus, ou « Aucune en cours »), puis une ligne par station suivie avec sa hauteur et sa tendance, colorée selon son état : bleu faible, vert normal, rouge élevé, gris sans plage habituelle ou sans mesure récente.
• Avec une station choisie : sa hauteur et son débit en direct, puis son état, son plus haut niveau récent, sa tendance et sa dernière mesure, et un lien vers sa page « Check for flooding ».
• Avec les alertes crues choisies : toutes les alertes en cours autour de votre maison.

Déclencheurs de scène

Déclencheur	Filtres	Variables
Alerte crue émise ou aggravée	Niveau (severe, warning, alert)	Niveau et niveau précédent (code et texte), code et nom de la zone, cours d'eau ou mer, comté, message, émise le
Alerte crue levée	Niveau qu'elle avait	Niveau (code et texte), code et nom de la zone, cours d'eau ou mer, comté
L'état du niveau d'eau change	Station, nouvel état (low, normal, high)	Nom de la station, cours d'eau, hauteur, état, état précédent (code et texte)
Niveau de référence franchi	Station, niveau, sens (rising, falling)	Nom de la station, cours d'eau, hauteur, code et nom du niveau, sa valeur, sens

« Émise ou aggravée » se déclenche pour une nouvelle alerte autour de votre maison, et pour une alerte qui s'aggrave (une vigilance devenue alerte). « Levée » se déclenche quand une alerte n'est plus en vigueur, ou manque au flux deux lectures de suite (un raté du flux ne lève rien) ; changer la distance ne déclenche rien. Les niveaux de référence proposés sont le bas et le haut de la plage habituelle, le plus haut niveau récent et le plus haut niveau connu ; une station ne déclenche que ceux qu'elle a. La descente compte une fois la hauteur 2 cm sous le niveau, et seulement ensuite une nouvelle montée peut compter : une hauteur qui oscille autour ne déclenche qu'une fois.

Les déclencheurs ne partent que pour un appareil que vous avez créé (la station, ou « Alertes crues »), sur des données fraîches, et pas après un redémarrage de plus d'un jour. La première lecture après l'installation ne déclenche rien : les alertes déjà en cours sont affichées par l'appareil et le widget.

Exemples de scènes

• Alerte crue à la maison : « Alerte crue émise ou aggravée », niveaux warning et severe → envoyer un message « {{severity_name}} : {{area_name}}. {{message}} », allumer l'entrée et couper les prises de la cave.
• Fin d'alerte : « Alerte crue levée » → message « Levée : {{area_name}} ».
• La rivière monte : « L'état du niveau d'eau change », votre station, nouvel état Élevé → prévenir la famille de déplacer la voiture.
• Nouveau record : « Niveau de référence franchi », niveau « Plus haut niveau récent », passe au-dessus → message « {{station_name}} : {{height}} m, au-dessus du {{mark_name}} ».

Sources, licence et quotas

• Données : Environment Agency, API de surveillance des crues en temps réel, licence Open Government Licence v3.0 (« Contains public sector information licensed under the Open Government Licence v3.0 » ; le widget cite la source).
• Les mesures sont quasi temps réel et non vérifiées : elles peuvent être corrigées plus tard. Les stations envoient toutes les 15 minutes, certaines moins souvent ; les alertes sont mises à jour toutes les 15 minutes.
• Sans compte, sans clé, sans quota documenté. L'intégration reste légère : une requête par mise à jour pour les dernières mesures de toutes les stations suivies et une pour les alertes en cours en Angleterre (15 minutes par défaut, jamais plus vite), le détail de chaque station une fois par jour, la liste des stations (environ 4 Mo) et celle des zones inondables (environ 3 Mo) une fois par semaine, et seulement si besoin.

Dépannage

• « Station inconnue » : vérifiez l'orthographe ou utilisez « Chercher des stations », puis copiez la référence.
• « L'Environment Agency ne répond pas » : le service ou votre accès à Internet est coupé ; les valeurs reviennent d'elles-mêmes.
• « Autour de ma maison » n'ajoute rien, ou pas d'appareil « Alertes crues » : donnez une position à votre maison (Paramètres, Maisons), ou choisissez une distance plus grande.
• Pas de fonctionnalité d'état : la station n'a pas de plage habituelle. Les stations de marée n'en ont jamais ici : la marée la traverse deux fois par jour.
• « Pas de nouvelle mesure depuis… » : la station envoie en retard ou plus du tout ; certaines envoient leurs valeurs par lots, avec quelques heures de retard.
• Une alerte que je reçois manque : le centre de sa zone est plus loin que la distance choisie : choisissez-en une plus grande.
• Journaux : dans Gladys, les logs de l'intégration ; LOG_LEVEL=debug pour voir chaque cycle.

Limites

• Aucun matériel nécessaire ; testée contre le service réel et contre des réponses enregistrées, mais pas encore dans une vraie installation de Gladys : vos retours sont les bienvenus.
• Angleterre seulement, et seulement ce que publie l'Environment Agency : pas de prévisions, pas d'alertes de ruissellement ou de nappe émises par d'autres organismes.
• La distance d'une alerte se mesure au centre de sa zone, pas à son contour.
• 20 stations au plus depuis la configuration (plus celles dont vous avez créé l'appareil).
• Les noms de fonctionnalités sont figés à la création de l'appareil : changer la langue ensuite ne change que les textes envoyés après.

Paramètres de configuration

Voici les paramètres demandés par Environment Agency Flood dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Vos stations et alertes crues	section	Non	Suivez les hauteurs d'eau des stations de l'Environment Agency en Angleterre, par référence, par nom ou près de votre maison, et les alertes crues autour d'elle. « Chercher des stations » les liste. Enregistrez, puis créez les appareils dans l'onglet Découverte.
Sources et limites	section	Non	Données : API de surveillance des crues en temps réel de l'Environment Agency, Open Government Licence v3.0, lues sans compte. Angleterre seulement. Pas un service d'alerte crues : fiez-vous aux alertes officielles (Floodline 0345 988 1188). Non affiliée à l'Environment Agency.
Stations	string	Non	Références ou noms de stations, séparés par des virgules.
Stations autour de ma maison	select	Non	Suivre aussi les 3 stations les plus proches qui envoient des mesures, à cette distance au plus de la position de votre maison dans Gladys.
Alertes crues autour de ma maison	select	Non	Un appareil « Alertes crues » suit les alertes dont la zone a son centre à cette distance au plus de votre maison.
Fréquence de mise à jour	select	Non	Les stations envoient une mesure toutes les 15 minutes et les alertes sont mises à jour toutes les 15 minutes. Une seule requête couvre toutes les stations.
Langue des noms de fonctionnalités	select	Non	Noms donnés aux fonctionnalités des nouveaux appareils (Hauteur d'eau, Débit…), et langue de leurs textes et des variables de scène.

Comment installer Environment Agency Flood dans Gladys

1. Dans Gladys, ouvrez Intégrations : Environment Agency Flood 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-ea-flood: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-ea-flood.

Environment Agency Flood nécessite Gladys >=5.1.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

Environment Agency Flood 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 🙂