Intégration domotique Vigicrues, gratuite et open source
Vigilance crues, hauteur, débit et prévisions des cours d'eau près de chez vous, par Vigicrues.
Publiée par guim31
- Appareils
- Version 1.2.1
- Nécessite Gladys >=5.2.0
- ★ 0
Amène dans Gladys la vigilance crues officielle (Vigicrues) et la hauteur et le débit des cours d'eau près de chez vous, à partir des données ouvertes de Vigicrues et de Hub'Eau. Sans compte ni clé.
C'est un complément, pas un système d'alerte de sécurité. Les données peuvent être en retard, manquer ou être fausses, et l'intégration dépend de votre Gladys, de votre accès à Internet et de deux services publics. En cas de crue, suivez les consignes officielles (vigicrues.gouv.fr, la préfecture, votre mairie, le 112). Intégration non affiliée au SCHAPI / Vigicrues ni à l'État.
Ce que vous obtenez
- Un appareil par station de mesure suivie : hauteur d'eau en mètres, débit en m³/h (ou en m³/s, au choix) quand la station en mesure un, vigilance crues de son tronçon (vert, jaune, orange, rouge) et date de la dernière mesure.
- Une station qui n'envoie plus rien est signalée comme telle (« Pas de nouvelle mesure depuis… ») : une vieille valeur n'est jamais republiée comme si elle était fraîche.
- Pour les stations que Vigicrues prévoit, la prévision de la hauteur (et du débit quand elle est publiée) : le pic attendu et la valeur dans 24 h, centrale, basse et haute, avec l'heure du pic.
- Deux déclencheurs de scène : « La vigilance crues monte » (jaune, orange ou rouge) et « La vigilance crues redescend », filtrés par station, tronçon et couleur.
- Un widget de tableau de bord : vos stations, leur hauteur, sa tendance (monte, stable, baisse) et la couleur de vigilance.
- Un bouton « Chercher des stations » qui liste les stations autour de votre maison, dans une commune ou un département, avec leur cours d'eau.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Un accès à Internet depuis Gladys : l'intégration lit
hubeau.eaufrance.fretwww.vigicrues.gouv.fr. - Pour « Autour de ma maison » : la position de votre maison dans Gladys (Paramètres, Maisons). Avec plusieurs maisons, choisissez la vôtre dans le réglage Maison. L'intégration la demande à l'installation (permission « localisation ») ; elle ne sert qu'à trouver les stations les plus proches, n'est ni enregistrée ni écrite dans les logs.
- La France métropolitaine pour la vigilance. Hub'Eau couvre aussi les départements d'outre-mer : leurs stations ont hauteur et débit, sans vigilance.
Configuration
Réglages
| Réglage | Ce qu'il fait |
|---|---|
| Codes des stations | Codes séparés par des virgules (O200004001, B540001001), ou les adresses des pages des stations sur vigicrues.gouv.fr. |
| Communes (codes INSEE) | Toutes les stations en service de ces communes : 31555 pour Toulouse, 75056 pour Paris. Le code INSEE n'est pas le code postal. |
| Maison | La maison dont la position sert à « Autour de ma maison » et à « Chercher des stations ». Vide : la première maison de Gladys qui a une position. |
| Autour de ma maison | Suit aussi les 3 stations les plus proches qui envoient des mesures, à 5, 10 ou 20 km de votre maison. |
| Fréquence de mise à jour | 15 (par défaut), 20 ou 30 minutes. La vigilance et les prévisions sont lues toutes les 30 minutes. |
| Unité du débit | m³/h (par défaut) : l'unité que Gladys affiche partout. m³/s : l'unité de Vigicrues, sans unité dans Gladys (le nom de la fonctionnalité la donne). |
| Langue des noms de fonctionnalités | Noms des fonctionnalités des nouveaux appareils et langue de leurs textes (couleur, dernière mesure). Français par défaut. |
La configuration apporte 20 stations au plus. Enregistrez, puis ouvrez l'onglet Découverte et créez les appareils voulus. Une station dont vous avez créé l'appareil reste suivie même si vous la retirez des réglages : supprimez l'appareil pour arrêter.
Trouver vos stations
Le bouton Chercher des stations de la configuration liste les stations en service, les plus proches d'abord, avec leur cours d'eau, leur distance et si elles ont envoyé une mesure ces dernières heures. Tapez, dans le champ « Où » :
- rien : les stations autour de la maison choisie dans les réglages (10 km, ou la distance choisie) ;
- un code INSEE de commune :
31555; - un département et un nom :
31 Toulouse,75 Seine,08 Meuse; - un code de station :
O200004001.
Copiez les codes voulus dans Codes des stations, puis enregistrez. Le code d'une station est aussi la fin de l'adresse de sa page sur vigicrues.gouv.fr.
Appareils
Un appareil par station, nommé comme Hub'Eau la nomme (« La Meuse à Charleville-Mézières »). Ses fonctionnalités sont en lecture seule :
| Fonctionnalité | Type (Gladys) | Valeur |
|---|---|---|
| Hauteur d'eau | Profondeur du liquide, en m | Hauteur à l'échelle, au-dessus de son zéro : une valeur négative est normale à l'étiage. Ce n'est pas une altitude. |
| Débit | Débit d'eau, en m³/h | Converti depuis les m³/s de Vigicrues (1 m³/s = 3 600 m³/h). Avec l'unité m³/s, la fonctionnalité s'appelle « Débit (m³/s) » et n'a pas d'unité : Gladys n'en a pas pour les m³/s. Seulement si la station mesure un débit. |
| Vigilance crues | Niveau de risque | La couleur du tronçon de la station, en pastille de risque Gladys : 0 vert, 1 jaune, 2 orange, 3 rouge. Seulement pour une station Vigicrues. |
| Couleur de vigilance | Texte | Vert, Jaune, Orange ou Rouge. |
| Dernière mesure | Texte | Date de la dernière mesure (« 29/09 15:30 »), ou « Pas de nouvelle mesure depuis… » après 3 heures sans mesure. |
La hauteur et le débit ne sont envoyés que quand ils changent, et une fois toutes les 12 heures sinon. Après 3 heures sans nouvelle mesure, ils ne sont plus envoyés : Gladys affiche leur âge réel. Une station qui se met à mesurer un débit reçoit la fonctionnalité : l'onglet Découverte propose alors de mettre l'appareil à jour.
Changer d'unité du débit change la structure des appareils : l'onglet Découverte propose « Mettre à jour » pour chaque station qui mesure un débit. Tant que vous ne l'avez pas fait, le débit reste envoyé dans l'unité de l'appareil créé, pour ne jamais mélanger les deux. Le nom d'une fonctionnalité est figé à sa création : renommez-la dans l'appareil (« Débit » ou « Débit (m³/s) ») si besoin. L'historique déjà enregistré garde son ancienne unité.
Prévisions
Pour les stations que Vigicrues prévoit (surtout sur les grands cours d'eau, comme la Loire à Montjean-sur-Loire), l'appareil reçoit des fonctionnalités de prévision, dans les unités des mesures :
| Fonctionnalité | Valeur |
|---|---|
| Hauteur : pic prévu (central), (bas), (haut) | La plus haute hauteur attendue sur l'horizon de la prévision (1 à 3 jours), dans le scénario central et aux bornes basse et haute de sa fourchette (80 %). |
| Hauteur : heure du pic prévu | Quand le pic central est attendu (« 17/10 13:00 »). |
| Hauteur dans 24 h (centrale), (basse), (haute) | La hauteur attendue dans 24 heures, dans les trois mêmes scénarios. Pas envoyée quand 24 heures dépassent l'horizon. |
| Débit : pic prévu…, Débit dans 24 h… | La même chose pour le débit, seulement quand Vigicrues le prévoit aussi (rare), en m³/h ou en m³/s comme le débit. |
| Prévision produite le | Date de production de la prévision, ou « Aucune prévision en cours » une fois son dernier point passé. |
Chaque scénario a son propre pic : les pics bas et haut peuvent tomber à une autre heure que le central. Les prévisions sont lues toutes les 30 minutes (Vigicrues en produit quelques-unes par jour), et une valeur n'est envoyée que quand elle change. Le pic dit jusqu'où l'eau monte sur l'horizon, la valeur à 24 h à quelle vitesse elle arrive : une valeur à 48 h ajouterait trois fonctionnalités par grandeur pour un niveau situé le plus souvent entre les deux.
Appareils existants : les fonctionnalités de prévision apparaissent la première fois que Vigicrues envoie une prévision pour la station ; l'onglet Découverte propose alors « Mettre à jour » pour son appareil. Les fonctionnalités existantes gardent leurs identifiants et leur historique. La plupart des stations n'ont pas de prévision : leurs appareils ne changent pas.
Widget
Ajoutez le widget Vigicrues à un tableau de bord.
- Sans réglage : une ligne par station (10 au plus) avec sa hauteur et sa tendance, colorée selon la vigilance de son tronçon : vert, jaune, rouge pour orange et rouge (la palette des widgets n'a pas d'orange, le titre donne la couleur exacte). Gris : pas de tronçon, ou pas de mesure récente.
- Avec une station choisie : ses tuiles de hauteur et de débit (avec son unité, m³/h ou m³/s), en direct, puis sa vigilance avec le nom du tronçon, sa tendance et sa dernière mesure.
Pour une station que Vigicrues prévoit, le détail se termine par le pic prévu : valeur centrale, fourchette et heure (« 2,9 m (2,56/3,24) · 01/10 16:40 »).
Le widget se termine par la source et sa date, et un lien vers Vigicrues.
Déclencheurs de scène
La vigilance crues monte : le tronçon d'une station suivie passe au jaune, à l'orange ou au rouge, ou à une couleur plus haute. La vigilance crues redescend : il revient à une couleur plus basse.
Filtres (tous facultatifs) : la station, le code du tronçon (visible dans les
paramètres de l'appareil, VIGICRUES_SECTION, par exemple LO18) et la nouvelle couleur.
Sans filtre de station, une scène se lance une fois par station suivie du tronçon.
Variables pour les actions : station_name, river, section, section_name, color
(green, yellow, orange, red), color_name (dans la langue des réglages),
previous_color, previous_color_name.
Les déclencheurs ne partent que pour les stations dont l'appareil existe, jamais à la première lecture, et pas après plus d'un jour sans vigilance (redémarrage, Vigicrues injoignable). Un seuil de hauteur est une condition de scène sur la fonctionnalité « Hauteur d'eau », pas un déclencheur.
Un seuil sur la prévision n'a pas besoin d'un déclencheur de l'intégration : utilisez le déclencheur natif « Changement d'état de l'appareil » sur « Hauteur : pic prévu (haut) » (ou central, ou bas : selon la prudence voulue), avec l'option qui ne déclenche qu'au franchissement du seuil. La scène part alors une fois quand la prévision passe au-dessus du seuil, pas à chaque nouvelle prévision. Le seuil est en mètres, ou dans l'unité de l'appareil pour un débit.
Exemples de scènes
- Orange ou rouge près de chez soi : déclencheur « La vigilance crues monte », couleur orange et rouge → envoyer le message « Vigilance {{color_name}} sur {{section_name}} : consultez vigicrues.gouv.fr » et passer une lampe en rouge.
- Fin d'alerte : déclencheur « La vigilance crues redescend », couleur vert → message « Retour au vert sur {{section_name}} ».
- Seuil de hauteur : déclencheur « Changement d'état de l'appareil » sur « Hauteur d'eau » de votre station, au-dessus de 3,5 m → envoyer un message à toute la maison.
- Prévision haute au-dessus de 4,5 m : mettre ses biens hors d'eau : déclencheur « Changement d'état de l'appareil » sur « Hauteur : pic prévu (haut) » de votre station, au-dessus de 4,5 m, seulement au franchissement du seuil → envoyer le message « La prévision haute de Vigicrues dépasse 4,5 m : regardez l'heure du pic et vigicrues.gouv.fr ». Avec le pic central, l'alerte vient plus tard et moins souvent.
- Station muette : rien à faire, la fonctionnalité « Dernière mesure » le dit sur le tableau de bord.
Sources des données, licence et quotas
- Vigicrues (
www.vigicrues.gouv.fr/services) : la vigilance de chaque tronçon (InfoVigiCru.geojson, environ 2,2 Mo, émis au moins deux fois par jour), lue toutes les 30 minutes, et les stations de chaque tronçon (lues une fois par semaine). © VIGICRUES. - Prévisions de Vigicrues (
previsions.json) : pour les stations qui en ont, des points horaires avec une valeur centrale et une fourchette à 80 %, lus toutes les 30 minutes. Une station sans prévision est redemandée toutes les 6 heures. © VIGICRUES. - Hub'Eau Hydrométrie (
hubeau.eaufrance.fr/api/v2/hydrometrie) : les stations et leurs mesures en temps réel, mises à jour toutes les 5 minutes depuis la plateforme hydrométrique nationale, gardées un mois. Une requête par mise à jour pour toutes vos stations. - Les deux sont publiés sous la Licence Ouverte / Open Licence Etalab 2.0 : réutilisation libre en citant la source et sa date — le widget affiche les deux.
- Aucun des deux services ne publie de quota. L'intégration reste légère : une requête Hub'Eau par mise à jour (15 minutes au plus vite), la vigilance toutes les 30 minutes, le référentiel une fois par semaine, et elle se nomme dans ses requêtes. Hub'Eau peut refuser un usage abusif : ne réduisez pas ces délais.
Dépannage
- « Code de station inconnu » : Hub'Eau ne connaît pas ce code. Vérifiez-le avec « Chercher des stations » ou sur vigicrues.gouv.fr (la fin de l'adresse de la page de la station).
- Pas de fonctionnalité de vigilance : la station n'est pas sur un tronçon Vigicrues (beaucoup de petits cours d'eau sont seulement mesurés), ou Vigicrues n'a pas répondu à la publication de l'appareil : l'intégration réessaie toutes les heures, puis l'onglet Découverte propose de mettre l'appareil à jour.
- Pas de fonctionnalité de prévision : Vigicrues ne prévoit pas cette station (la plupart des stations), voyez sa page sur vigicrues.gouv.fr. Si elle en a une, « Mettre à jour » l'appareil dans l'onglet Découverte. Une prévision de hauteur sans prévision de débit est normale : Vigicrues ne prévoit souvent que la hauteur (Montjean-sur-Loire, par exemple).
- Pas de fonctionnalité de débit : la station ne mesure que la hauteur (Charleville-Mézières, par exemple).
- « Pas de nouvelle mesure depuis… » : la station n'envoie plus rien (maintenance, panne, dégâts de crue). Hub'Eau garde un mois : au-delà, « Aucune mesure depuis plus d'un mois ».
- « Hub'Eau ne répond pas » ou « Vigicrues ne répond pas » dans la configuration : le service est en panne ou Gladys n'a pas accès à Internet. Les valeurs reviennent toutes seules.
- « Autour de ma maison » ne fait rien : indiquez la position de votre maison dans Gladys (Paramètres, Maisons) ; l'écran de configuration le signale. Si vous avez choisi une maison dans le réglage Maison, c'est la sienne qui compte : l'écran de configuration la nomme quand elle n'a pas de position ou n'existe plus (choisissez-en une autre, ou videz le champ).
- Logs : calmes par défaut (démarrage, station muette ou revenue, changement de vigilance,
pannes une seule fois).
LOG_LEVEL=debugmontre chaque mise à jour.
Limites
- Pas un système d'alerte de sécurité : un complément seulement, sans garantie de délai ni de disponibilité. Les consignes officielles priment.
- La vigilance couvre la France métropolitaine seulement ; les services d'outre-mer de Vigicrues ne sont pas lus.
- Les hauteurs sont des cotes au-dessus du zéro de l'échelle de chaque station : elles ne se comparent ni d'une station à l'autre, ni à une altitude.
- Les mesures en temps réel sont brutes, non validées : des valeurs aberrantes arrivent.
- Certaines stations envoient une fois par heure, avec jusqu'à 75 minutes de retard environ.
- Les prévisions sont celles de Vigicrues, avec leur incertitude : le niveau est attendu dans la fourchette 8 fois sur 10, pas toujours. Vigicrues les révise quelques fois par jour.
- Testée sur de vraies réponses de Hub'Eau et de Vigicrues enregistrées en septembre et octobre 2026, pas encore sur un Gladys réel : vos retours sont bienvenus.
- Non affiliée au SCHAPI / Vigicrues, à l'État ni à Hub'Eau.
Paramètres de configuration
Voici les paramètres demandés par Vigicrues dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos stations | section | Non | Suivez les stations de mesure de vos cours d'eau : par code, par commune, ou les plus proches de votre maison. « Chercher des stations » ci-dessous les liste avec leur cours d'eau. Enregistrez, puis créez les appareils dans l'onglet Découverte. |
| Sources et limites | section | Non | Données © Vigicrues et Hub'Eau (Licence Ouverte Etalab 2.0), lues sans compte. Un complément, pas un système d'alerte de sécurité : les consignes officielles priment. Non affiliée à Vigicrues. |
| Codes des stations | string | Non | Codes séparés par des virgules, ou les adresses de leurs pages Vigicrues. |
| Communes (codes INSEE) | string | Non | Toutes les stations en service de ces communes, par exemple 31555 pour Toulouse, 75056 pour Paris. |
| Maison | select | Non | La maison dont la position sert à « Autour de ma maison » et à « Chercher des stations ». Vide : la première maison de Gladys qui a une position. |
| 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. |
| Fréquence de mise à jour | select | Non | Les stations envoient une mesure toutes les 5 à 60 minutes. La vigilance et les prévisions sont lues toutes les 30 minutes. |
| Unité du débit | select | Non | m³/h : l'unité que Gladys affiche sur tous ses écrans. m³/s : l'unité de Vigicrues, affichée sans unité (le nom de la fonctionnalité la donne). En cas de changement : « Mettre à jour » les appareils dans l'onglet Découverte. |
| 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 (couleur, dernière mesure). |
Comment installer Vigicrues dans Gladys
- Dans Gladys, ouvrez Intégrations : Vigicrues apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-vigicrues:1.2.1), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-vigicrues.
Vigicrues 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
Vigicrues 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