Intégration domotique Qualité de l'eau, gratuite et open source
Qualité de l'eau du robinet de votre commune et des baignades proches, par Hub'Eau et le ministère.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.2.0
- ★ 0
Cette intégration affiche dans Gladys la qualité de l'eau du robinet de votre commune et celle des sites de baignade proches (plages, lacs, rivières surveillés), à partir des résultats du contrôle sanitaire publiés par le ministère de la Santé. Données publiques, sans compte ni clé.
Une information, pas un système d'alerte sanitaire. Les résultats sont publiés avec plusieurs jours, parfois plusieurs semaines de retard. En cas de problème sur l'eau du robinet ou de baignade interdite, ce sont les avis de votre mairie, de votre distributeur d'eau et de l'ARS (agence régionale de santé) qui font foi. Intégration non affiliée à l'OFB / eaufrance ni au ministère de la Santé.
Développée sans accès aux services en direct (le réseau de la session de développement ne les atteignait pas) : elle a été écrite et testée sur des réponses enregistrées et des pages reconstruites. Vos retours sont les bienvenus, en particulier sur la baignade.
Présentation
- Un appareil « Eau du robinet · votre commune » : la conformité du dernier prélèvement (bactériologique et physico-chimique), sa date, la conclusion sanitaire rédigée par l'ARS, et quand elles sont mesurées les teneurs en nitrates, la dureté (titre hydrotimétrique, utile pour régler un adoucisseur ou un lave-vaisselle), le chlore et le pH.
- Un appareil par site de baignade : le résultat du dernier prélèvement (bon, moyen, mauvais) ou l'interdiction de baignade, sa date, et la saison (ouverte jusqu'au…, fermée).
- Deux déclencheurs de scène : « Eau du robinet non conforme » et « Baignade déconseillée ou interdite ».
- Un widget pour le tableau de bord, et une action « Chercher des sites de baignade ».
- Une lecture par jour : le ministère publie les résultats de l'eau du robinet environ une fois par mois, ceux de la baignade environ une fois par semaine en saison.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Un accès à Internet depuis Gladys vers
hubeau.eaufrance.fr,baignades.sante.gouv.fretgeo.api.gouv.fr. - Pour utiliser votre maison : sa position renseignée dans Gladys (Paramètres → Maisons).
L'intégration demande l'accès à la position des maisons (
location), ce qui est affiché à l'installation. Sans position, tapez simplement le code INSEE de votre commune. - Communes de France métropolitaine et d'outre-mer suivies par le contrôle sanitaire.
Installation et configuration
- Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et saisissez
https://github.com/guim31/gladys-qualite-eau(ou installez-la depuis le catalogue quand elle y figure). - Dans l'onglet Configuration :
- Maison : la maison dont la position donne la commune. Vide : la première maison de Gladys qui a une position.
- Communes (codes INSEE) : à remplir seulement pour suivre une autre commune que celle de la maison (une résidence secondaire, la commune de vos parents…), jusqu'à 5. Attention, le code INSEE n'est pas le code postal : Orléans a le code postal 45000 mais le code INSEE 45234. Vous le trouvez sur la fiche de la commune sur le site de l'INSEE ou sur Wikipédia.
- Sites de baignade suivis : ceux de vos communes (par défaut), ceux à 5, 10 ou 20 km de votre maison, ou seulement ceux que vous tapez.
- Sites de baignade : des codes donnés par « Chercher des sites de baignade », ou les adresses de leurs pages sur baignades.sante.gouv.fr.
- Langue des noms et des textes : le français par défaut.
- Enregistrez, puis ouvrez l'onglet Découverte et cliquez sur Ajouter à Gladys pour les appareils voulus.
Chercher des sites de baignade
L'action « Chercher des sites de baignade », dans l'onglet Configuration, liste les sites d'une commune (tapez son code INSEE) ou, champ vide, ceux des communes autour de votre maison (5, 10 ou 20 km), avec leur code. Copiez les codes voulus dans Sites de baignade, puis enregistrez.
Les appareils
Eau du robinet
| Fonctionnalité | Ce qu'elle montre |
|---|---|
| Conformité bactériologique | Pastille de risque : vert (conforme), jaune (conforme sous dérogation), rouge (non conforme) |
| Conformité physico-chimique | Idem, pour les paramètres chimiques (nitrates, pesticides, métaux…) |
| Conclusion sanitaire | Le texte de l'ARS pour le dernier prélèvement, par exemple « Eau d'alimentation conforme aux exigences de qualité en vigueur… » |
| Dernier prélèvement | La date du dernier prélèvement publié |
| Nitrates (mg/L) | La limite de qualité est 50 mg/L |
| Dureté (°f) | En degrés français : moins de 15 °f, eau douce ; plus de 30 °f, eau calcaire |
| Chlore (mg/L) | Le chlore libre, ou le chlore total s'il est le seul mesuré ; « <0,10 » (sous le seuil du laboratoire) est publié à 0 |
| pH | Entre 6,5 et 9 pour une eau conforme |
Chaque conformité vient du dernier prélèvement qui l'a évaluée : un contrôle de routine ne recherche souvent que les bactéries, sans analyse chimique. Les valeurs chiffrées sont les plus récentes des deux dernières années (la dureté n'est mesurée qu'une fois par an, voire moins, dans les petites communes). Gladys n'a pas d'unité pour les mg/L ni pour les degrés français : ces valeurs sont publiées sans unité, et le nom de la fonctionnalité la donne.
Les paramètres de l'appareil indiquent le distributeur (DISTRIBUTOR) et les réseaux de
distribution du dernier prélèvement (NETWORKS).
Site de baignade
| Fonctionnalité | Ce qu'elle montre |
|---|---|
| Qualité de l'eau | Pastille de risque : vert (bon), jaune (moyen), orange (mauvais), rouge (baignade interdite) ; rien hors saison |
| Dernier résultat | En toutes lettres : Bon, Moyen, Mauvais, Baignade interdite, Hors saison, Pas encore de prélèvement, Résultat non communiqué |
| Dernier prélèvement | La date du dernier résultat publié |
| Saison de baignade | « Ouverte jusqu'au 31/08 », « Fermée (saison du 15/06 au 31/08) », « Toute l'année » en outre-mer |
Le résultat d'un prélèvement (bon, moyen, mauvais) dépend des bactéries mesurées (E. coli, entérocoques). Ce n'est pas le classement de fin de saison (excellent, bon, suffisant, insuffisant), calculé sur quatre ans, que l'intégration ne lit pas.
Widget
Le widget Qualité de l'eau montre, sans réglage, une ligne par commune (conforme ou non, et sa dureté) et par site de baignade (dernier résultat et sa date), en couleur, la dureté de votre commune en grand, et un titre rouge quand l'eau du robinet est non conforme ou qu'une baignade est déconseillée. En choisissant un appareil dans ses réglages, il montre son détail : les nitrates, la dureté, le chlore et le pH en direct et la conclusion sanitaire pour une commune ; le résultat, la date et la saison, avec un lien vers la fiche officielle, pour un site.
Déclencheurs de scène
- Eau du robinet non conforme : un nouveau prélèvement d'une commune suivie dépasse une
limite de qualité. Filtre : la commune. Variables : nom de la commune, date du prélèvement,
conclusion sanitaire, conformités bactériologique et physico-chimique (
compliant,derogation,non_compliant,not_measured). Il ne se déclenche qu'une fois par prélèvement, jamais à la première lecture, ni pour un prélèvement de plus de 90 jours. - Baignade déconseillée ou interdite : un site suivi passe à un résultat mauvais ou à une
interdiction de baignade. Filtres : le site, le nouvel état (
poor,prohibited). Variables : nom du site, état, état en toutes lettres, date du dernier prélèvement.
Pour réagir au retour à la normale, utilisez le déclencheur natif de Gladys « l'état d'un appareil change » sur la pastille de l'appareil.
Exemples de scènes
- Alerte sur l'eau du robinet : déclencheur « Eau du robinet non conforme », action « Envoyer un message » qui reprend les variables du déclencheur : « Eau du robinet non conforme à nom de la commune (prélèvement du date) : conclusion sanitaire ».
- Avant d'aller à la plage : chaque samedi à 9 h, si la pastille « Qualité de l'eau » du lac vaut moins de 2, envoyer « Baignade possible au lac ce matin ».
- Baignade interdite : déclencheur « Baignade déconseillée ou interdite », état « interdite », action « Envoyer un message » à toute la famille.
- Adoucisseur : un graphique de la dureté sur un an, pour régler l'adoucisseur ou le lave-vaisselle.
Dépannage
- Aucun appareil dans l'onglet Découverte : l'écran de configuration dit pourquoi (maison sans position, code INSEE inconnu…). Donnez une position à votre maison ou tapez un code INSEE.
- « Aucun prélèvement publié depuis un an » : vérifiez que vous avez tapé le code INSEE et non le code postal. Pour Paris, Lyon et Marseille, essayez le code de la commune entière (75056, 69123, 13055) puis celui de l'arrondissement.
- Le dernier prélèvement date d'il y a plusieurs semaines : c'est normal, les résultats sont publiés une fois par mois environ.
- Un site de baignade reste « Hors saison » ou « Pas encore de prélèvement » : la saison n'a pas commencé, ou le premier prélèvement n'est pas encore publié.
- « Hub'Eau ne répond pas » ou « baignades.sante.gouv.fr ne répond pas » : le service est indisponible ; l'intégration réessaie toutes les heures et garde les dernières valeurs.
- Pour plus de détails, passez
LOG_LEVEL=debug: chaque lecture est alors écrite dans les journaux de l'intégration (jamais la position de votre maison).
Limites
- À l'échelle de la commune : dans une grande ville desservie par plusieurs réseaux, le
dernier prélèvement peut venir d'un autre quartier que le vôtre (le paramètre
NETWORKSle dit). - Les résultats arrivent avec retard : quelques jours à quelques semaines pour l'eau du robinet. Ce n'est pas une alerte en temps réel.
- La baignade se lit sur les pages du site baignades.sante.gouv.fr, qui n'a pas d'API publique documentée : un changement de ces pages peut casser la lecture jusqu'à une mise à jour de l'intégration. Le classement de fin de saison n'est pas lu.
- « Autour de ma maison » retient les communes dont le centre est dans le rayon, d'après geo.api.gouv.fr.
- 5 communes et 10 sites de baignade au plus.
- Rythme et quotas : aucun quota n'est publié par Hub'Eau ni par baignades.sante.gouv.fr ; l'intégration fait cinq ou six petites requêtes Hub'Eau par commune et par jour, une requête par site de baignade et par jour, et redemande la liste des sites et la commune de la maison une fois par semaine. geo.api.gouv.fr limite à 50 requêtes par seconde.
Sources et licence
- Eau du robinet : Hub'Eau – Qualité de l'eau potable, résultats du contrôle sanitaire du ministère de la Santé, Licence Ouverte Etalab 2.0.
- Baignade : baignades.sante.gouv.fr, ministère de la Santé et ARS.
- Communes : API Découpage administratif, Licence Ouverte Etalab 2.0.
- La position de votre maison n'est envoyée qu'à geo.api.gouv.fr, arrondie à environ 100 m, et n'est ni enregistrée ni écrite dans les journaux.
- Intégration non affiliée à l'OFB / eaufrance, au BRGM ni au ministère de la Santé. Code sous licence Apache 2.0.
Paramètres de configuration
Voici les paramètres demandés par Qualité de l'eau dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre eau du robinet et vos baignades | section | Non | L'eau du robinet de la commune de votre maison (ou des codes INSEE que vous tapez), et les sites de baignade de cette commune ou autour de votre maison. « Chercher des sites de baignade » ci-dessous les liste. Enregistrez, puis créez les appareils dans l'onglet Découverte. |
| Sources et limites | section | Non | Résultats du contrôle sanitaire publiés par le ministère de la Santé (Hub'Eau, baignades.sante.gouv.fr), lus une fois par jour sans compte. Une information, pas une alerte sanitaire : les avis de votre mairie et de l'ARS priment. Non affiliée à l'OFB / eaufrance. |
| Maison | select | Non | Sa position donne la commune de l'eau du robinet et les sites de baignade autour. Vide : la première maison de Gladys qui a une position. |
| Communes (codes INSEE) | string | Non | À la place de la commune de la maison : jusqu'à 5 codes INSEE (pas les codes postaux), par exemple 45234 pour Orléans, 75056 pour Paris. |
| Sites de baignade suivis | select | Non | Ceux des communes ci-dessus, ou ceux à une distance de votre maison (10 sites au plus). |
| Sites de baignade | string | Non | Codes donnés par « Chercher des sites de baignade », ou adresses de leurs pages sur baignades.sante.gouv.fr, séparés par des virgules. |
| Langue des noms et des textes | select | Non | Noms des nouveaux appareils et fonctionnalités (Eau du robinet, Dureté…) et langue de leurs textes (résultats, saison). |
Comment installer Qualité de l'eau dans Gladys
- Dans Gladys, ouvrez Intégrations : Qualité de l'eau 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-qualite-eau:1.0.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-qualite-eau.
Qualité de l'eau 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
Qualité de l'eau 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