Integración domótica Nappes phréatiques, gratuita y de código abierto
Profundidad, nivel y situación de las aguas subterráneas cerca de su casa (Francia), por Hub'Eau.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
El nivel de las aguas subterráneas cerca de su casa, según los piezómetros públicos de la red francesa ADES (BRGM), leídos mediante la API abierta Hub'Eau Piézométrie. Sin cuenta ni clave.
Cada estación (un piezómetro, un pozo donde se mide el acuífero) se convierte en un dispositivo de Gladys: la profundidad del acuífero, su nivel, la fecha de la última medición y una situación (muy baja a muy alta) que esta integración estima a partir del historial de la estación.
La situación es una estimación de esta integración, no es el indicador oficial del BRGM (el «IPS» mensual de los boletines de aguas subterráneas). Sin afiliación con el BRGM ni con Hub'Eau.
Lo que obtiene
- Un dispositivo por estación: profundidad del acuífero bajo el suelo (m), su nivel (m NGF, la nivelación general de Francia), un índice de situación de 1 (muy bajo) a 5 (muy alto), la situación en palabras y la fecha de la última medición.
- Estaciones por código o alrededor de su casa (las 3 más cercanas que siguen midiendo, según la ubicación de su casa en Gladys).
- «Buscar estaciones» en la pantalla de configuración: las estaciones alrededor de su casa, en un municipio o un departamento, con su distancia, su primer año y su última medición.
- Disparadores de escena: La situación del acuífero cambia (filtrado por estación y nueva situación) y Estación sin medición (7, 15, 30 o 60 días).
- Widget: las estaciones seguidas con su profundidad, su situación y la tendencia de la semana, o el detalle de una estación.
Vecinas: Vigicrues da los ríos (altura, caudal, vigilancia de crecidas), la integración VigiEau las restricciones de agua oficiales de su municipio: ambas complementan a esta.
Requisitos
- Gladys Assistant 5.1.0 o posterior (widget y disparadores de escena).
- Acceso a Internet desde Gladys hacia
hubeau.eaufrance.fr. - Para «alrededor de mi casa»: una ubicación para su casa en Gladys (Ajustes, Casas).
- Solo Francia (metrópoli y departamentos de ultramar, la red ADES).
Configuración
Ajustes
| Ajuste | Función |
|---|---|
| Códigos de estación | Códigos BSS separados por comas, nuevos (BSS002FVWC) o antiguos (09838D0727/F). |
| Alrededor de mi casa | Seguir también las 3 estaciones en servicio más cercanas, a 10, 20, 30 o 50 km de su casa. |
| Idioma de los nombres de las funciones | Nombres de las funciones de los nuevos dispositivos e idioma de los textos (situación, medición). |
Guarde, abra la pestaña Descubrir y cree los dispositivos que desee. Una estación cuyo dispositivo ha creado sigue siendo seguida aunque la quite de la configuración; eliminar el dispositivo la detiene. La configuración sigue 10 estaciones como máximo.
Encontrar sus estaciones
La acción Buscar estaciones de la pantalla de configuración enumera las estaciones con su código, su distancia a su casa, el año de su primera medición y la fecha de la última:
- deje Dónde vacío: las estaciones en servicio alrededor de su casa (20 km, o la distancia elegida);
- un código INSEE de municipio (
31555para Toulouse): todas las estaciones del municipio, primero las que están en servicio; - un número de departamento (
31,2A,974): las estaciones en servicio allí; - un código de estación, nuevo o antiguo.
Copie el código (BSS…) en Códigos de estación y guarde. Los piezómetros en servicio son escasos
(una docena en Haute-Garonne): elija una estación sobre el mismo acuífero que su pozo o su jardín,
indicado en los parámetros del dispositivo (AQUIFER). El portal ADES
las muestra en un mapa.
Dispositivos
| Función | Tipo | Contenido |
|---|---|---|
| Profundidad del acuífero | Profundidad del líquido, m | Profundidad del acuífero bajo el suelo (negativa: por encima, artesiano) |
| Nivel del acuífero (m NGF) | Profundidad del líquido, m | Altitud del nivel freático |
| Índice de situación (1 a 5) | Contador | 1 muy bajo, 2 bajo, 3 normal, 4 alto, 5 muy alto |
| Situación del acuífero | Texto | La situación en palabras, o por qué es desconocida |
| Última medición | Texto | Fecha de la medición más reciente (con la hora en tiempo real) |
La profundidad y el nivel dejan de publicarse 45 días después de la última medición; «Última medición» siempre indica cuándo fue. Una estación leída a mano una vez al mes es normal. Cuando la situación pasa a desconocida, el índice conserva su último valor: una condición de escena sobre el índice debe comprobar también que «Situación del acuífero» no sea desconocida.
Cómo se estima la situación
El nivel medio de los últimos 10 días se clasifica entre los niveles medios de los mismos 31 días (la misma fecha ± 15 días) de cada año anterior de la estación. Más bajo que el 90 % de los años: muy bajo; más bajo que el 70 %: bajo; entre ambos: normal; más alto que el 70 %: alto; más alto que el 90 %: muy alto. Se necesitan al menos 10 años de historial y una medición de menos de 30 días; si no, la situación es «desconocida», con el motivo. No es el indicador oficial del BRGM, que trabaja con medias mensuales estandarizadas: ambos suelen coincidir, pero no siempre.
Widget
Añada el widget Aguas subterráneas a un panel:
- sin estación: una línea por estación seguida con su profundidad y su situación, coloreada según la situación (rojo muy bajo, amarillo bajo, verde normal, azul alto y muy alto), el icono indica la tendencia de la semana (sube, estable, baja);
- con una estación: su profundidad y su nivel en directo, su situación, tendencia y última medición, y un enlace a su ficha en el portal ADES.
Disparadores de escena
La situación del acuífero cambia: la situación estimada de una estación cambia. Filtros: la estación y las nuevas situaciones (muy bajo, bajo, normal, alto, muy alto). Variables: nombre de la estación, situación (clave y palabras), situación anterior (clave y palabras), profundidad, nivel.
Estación sin medición: una estación seguida no ha enviado nada desde hace 7, 15, 30 o 60 días. Cada duración se dispara una vez por silencio; tras una larga parada de Gladys, solo la más larga alcanzada. Variables: nombre de la estación, días, fecha de la última medición.
Un umbral de profundidad («más de 8 m») es una condición de escena sobre el estado del dispositivo: los disparadores solo filtran por igualdad.
Ejemplos de escenas
- Pozo bajo vigilancia: cuando la situación de su estación pasa a bajo o muy bajo, enviar «Acuífero {{situation_name}} en {{station_name}}: riegue con moderación».
- Vuelta a la normalidad: cuando la situación pasa a normal, enviar un mensaje y reactivar la escena de riego del jardín.
- Datos caducados: cuando su estación lleva 30 días en silencio, enviar un recordatorio para elegir otra con «Buscar estaciones».
- Informe semanal: cada lunes, enviar los valores «Situación del acuífero» y «Profundidad del acuífero».
Fuentes de datos, licencia y cuotas
- Datos: Hub'Eau Piézométrie v1, procedentes de ADES (BRGM y socios), bajo la Licence Ouverte Etalab 2.0; el widget cita la fuente y la fecha.
- Solicitudes: todo el historial diario de una estación una vez (alrededor de 1 MB, unos segundos), luego cada 6 horas dos pequeñas solicitudes por estación (los valores diarios de la última semana, el valor en tiempo real más reciente); el historial se vuelve a leer cada 90 días. Hub'Eau no publica cuotas: este ritmo queda muy por debajo de cualquier límite razonable.
- Los valores diarios suelen llegar al día siguiente; los valores en tiempo real cada hora, para las estaciones que los envían, a veces con unos días de retraso.
Solución de problemas
- «Código de estación desconocido»: el código no existe en Hub'Eau. Use «Buscar estaciones» y copie el código indicado.
- «Ninguna estación en servicio a esta distancia»: elija una distancia mayor, o una estación por código.
- «Hub'Eau no responde»: el servicio está caído o lento; los valores vuelven solos.
- Situación «desconocida: menos de 10 años de historial»: la estación es demasiado reciente para una estimación. La profundidad y el nivel se siguen publicando.
- Situación «desconocida: sin medición reciente»: la estación no ha enviado nada desde hace 30 días.
- «Sin valor reciente» en la profundidad: la última medición tiene más de 45 días; vea «Última medición».
- Registros:
LOG_LEVEL=debugmuestra cada ciclo de lectura.
Límites
- Solo Francia (red ADES) y solo los piezómetros públicos: no su propio pozo.
- La situación es una estimación, no el indicador oficial del BRGM; un acuífero confinado o explotado puede seguir «muy bajo» durante años.
- Actualización cada 6 horas: las aguas subterráneas se mueven despacio y los datos son diarios.
- 10 estaciones como máximo desde la configuración.
- Desarrollada y probada con los datos reales de estaciones alrededor de Toulouse; sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que Nappes phréatiques te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus estaciones | section | No | Siga las estaciones de medición de las aguas subterráneas (piezómetros) cercanas: por código o las más cercanas a su casa. «Buscar estaciones» más abajo las enumera. Guarde y cree los dispositivos en la pestaña Descubrir. |
| Fuentes y límites | section | No | Datos: Hub'Eau y ADES (BRGM), Licence Ouverte Etalab 2.0, leídos sin cuenta cada 6 horas. La situación es una estimación de esta integración, no el indicador oficial del BRGM. Sin afiliación con el BRGM. |
| Códigos de estación | string | No | Códigos BSS separados por comas, nuevos (BSS002FVWC) o antiguos (09838D0727/F). |
| Alrededor de mi casa | select | No | Seguir también las 3 estaciones en servicio más cercanas, como máximo a esta distancia de la ubicación de su casa en Gladys. |
| Idioma de los nombres de las funciones | select | No | Nombres de las funciones de los nuevos dispositivos (Profundidad del acuífero, Situación…) e idioma de sus textos (situación, última medición). |
Cómo instalar Nappes phréatiques en Gladys
- En Gladys, abre Integraciones: Nappes phréatiques aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-nappes:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-nappes.
Nappes phréatiques requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Nappes phréatiques es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación