Integración domótica Vigicrues, gratuita y de código abierto
Vigilancia de crecidas, altura y caudal de los ríos cerca de su casa (Francia), por Vigicrues.
Publicado por guim31
- Dispositivos
- Versión 1.1.0
- Requiere Gladys >=5.2.0
- ★ 0
Lleva a Gladys la vigilancia de crecidas oficial francesa (Vigicrues) y la altura y el caudal de los ríos cerca de su casa, a partir de los datos abiertos de Vigicrues y Hub'Eau. Sin cuenta ni clave.
Es un complemento, no un sistema de alerta de seguridad. Los datos pueden llegar tarde, faltar o ser erróneos, y la integración depende de su Gladys, de su acceso a Internet y de dos servicios públicos. En caso de crecida, siga las instrucciones oficiales (vigicrues.gouv.fr, la prefectura, su ayuntamiento, el 112). Esta integración no está afiliada al Estado francés (Vigicrues, SCHAPI).
Lo que obtiene
- Un dispositivo por estación de medición seguida: altura del agua en metros, caudal en m³/h (o en m³/s, a su elección) cuando la estación lo mide, la vigilancia de crecidas de su tramo de río (verde, amarillo, naranja, rojo) y la fecha de la última medición.
- Una estación que deja de enviar datos se muestra como tal («Sin nueva medición desde…»): un valor antiguo nunca se vuelve a enviar como si fuera reciente.
- Dos activadores de escena: «La vigilancia de crecidas sube» (amarillo, naranja o rojo) y «La vigilancia de crecidas baja», filtrados por estación, tramo y color.
- Un widget para el panel: sus estaciones, su altura, su tendencia (sube, estable, baja) y el color de vigilancia.
- Un botón «Buscar estaciones» que enumera las estaciones alrededor de su casa, en un municipio o un departamento, con su río.
Requisitos
- Gladys Assistant 5.2.0 o posterior.
- Acceso a Internet desde Gladys: la integración lee
hubeau.eaufrance.frywww.vigicrues.gouv.fr. - Para «Alrededor de mi casa»: la ubicación de su casa en Gladys (Ajustes, Casas). Con varias casas, elija la suya en el ajuste Casa. La integración la solicita en la instalación (permiso de «ubicación»); solo sirve para encontrar las estaciones más cercanas y nunca se guarda ni se escribe en los registros.
- La Francia metropolitana para la vigilancia. Hub'Eau también cubre los departamentos de ultramar: sus estaciones tienen altura y caudal, sin vigilancia.
Configuración
Ajustes
| Ajuste | Qué hace |
|---|---|
| Códigos de estación | Códigos separados por comas (O200004001, B540001001), o las direcciones de las páginas de las estaciones en vigicrues.gouv.fr. |
| Municipios (códigos INSEE) | Todas las estaciones en servicio de estos municipios: 31555 para Toulouse, 75056 para París. El código INSEE no es el código postal. |
| Casa | La casa cuya ubicación usan «Alrededor de mi casa» y «Buscar estaciones». Vacío: la primera casa de Gladys que tiene ubicación. |
| Alrededor de mi casa | Sigue también las 3 estaciones más cercanas que envían mediciones, a 5, 10 o 20 km de su casa. |
| Intervalo de actualización | 15 (por defecto), 20 o 30 minutos. La vigilancia se lee cada 30 minutos. |
| Unidad del caudal | m³/h (por defecto): la unidad que Gladys muestra en todas partes. m³/s: la unidad de Vigicrues, sin unidad en Gladys (el nombre de la función la indica). |
| Idioma de los nombres de las funciones | Nombres de las funciones de los nuevos dispositivos e idioma de sus textos (color, última medición). Francés por defecto. |
La configuración aporta 20 estaciones como máximo. Guarde, abra la pestaña Descubrir y cree los dispositivos que desee. Una estación cuyo dispositivo haya creado sigue en seguimiento aunque la quite de los ajustes: elimine el dispositivo para dejar de seguirla.
Encontrar sus estaciones
El botón Buscar estaciones de la configuración enumera las estaciones en servicio, las más cercanas primero, con su río, su distancia y si han enviado una medición en las últimas horas. Escriba, en el campo «Dónde»:
- nada: las estaciones alrededor de la casa elegida en los ajustes (10 km, o la distancia elegida);
- un código INSEE de municipio:
31555; - un departamento y un nombre:
31 Toulouse,75 Seine,08 Meuse; - un código de estación:
O200004001.
Copie los códigos que desee en Códigos de estación y guarde. El código de una estación es también el final de la dirección de su página en vigicrues.gouv.fr.
Dispositivos
Un dispositivo por estación, con el nombre que le da Hub'Eau («La Meuse à Charleville-Mézières»). Sus funciones son de solo lectura:
| Función | Tipo (Gladys) | Valor |
|---|---|---|
| Altura del agua | Profundidad del líquido, en m | Altura en la escala, por encima de su cero: un valor negativo es normal en estiaje. No es una altitud. |
| Caudal | Caudal de agua, en m³/h | Convertido desde los m³/s de Vigicrues (1 m³/s = 3600 m³/h). Con la unidad m³/s, la función se llama «Caudal (m³/s)» y no tiene unidad: Gladys no tiene ninguna para los m³/s. Solo si la estación mide un caudal. |
| Vigilancia de crecidas | Nivel de riesgo | El color del tramo de la estación, como la insignia de riesgo de Gladys: 0 verde, 1 amarillo, 2 naranja, 3 rojo. Solo para una estación Vigicrues. |
| Color de vigilancia | Texto | Verde, Amarillo, Naranja o Rojo. |
| Última medición | Texto | Fecha de la última medición («29/09, 15:30»), o «Sin nueva medición desde…» tras 3 horas sin medición. |
La altura y el caudal solo se envían cuando cambian, y una vez cada 12 horas en caso contrario. Tras 3 horas sin nueva medición dejan de enviarse, para que Gladys muestre su antigüedad real. Una estación que empieza a medir un caudal recibe la función: la pestaña Descubrir propone entonces actualizar el dispositivo.
Cambiar la unidad del caudal cambia la estructura de los dispositivos: la pestaña Descubrir propone «Actualizar» para cada estación que mide un caudal. Mientras no lo haga, el caudal se sigue enviando en la unidad del dispositivo creado, para no mezclar nunca las dos. El nombre de una función se fija al crearla: cámbielo en el dispositivo («Caudal» o «Caudal (m³/s)») si lo necesita. El historial ya guardado conserva su unidad anterior.
Widget
Añada el widget Vigicrues a un panel.
- Sin ajuste: una línea por estación (10 como máximo) con su altura y su tendencia, coloreada según la vigilancia de su tramo: verde, amarillo, rojo para naranja y rojo (la paleta de los widgets no tiene naranja, el título indica el color exacto). Gris: sin tramo, o sin medición reciente.
- Con una estación elegida: sus mosaicos de altura y caudal (con su unidad, m³/h o m³/s), en directo, y después su vigilancia con el nombre del tramo, su tendencia y su última medición.
El widget termina con la fuente y su fecha, y un enlace a Vigicrues.
Activadores de escena
La vigilancia de crecidas sube: el tramo de una estación seguida pasa a amarillo, naranja o rojo, o a un color superior. La vigilancia de crecidas baja: vuelve a un color inferior.
Filtros (todos opcionales): la estación, el código del tramo (visible en los
parámetros del dispositivo, VIGICRUES_SECTION, p. ej. LO18) y el nuevo color. Sin
filtro de estación, una escena se ejecuta una vez por cada estación seguida del tramo.
Variables para las acciones: station_name, river, section, section_name, color
(green, yellow, orange, red), color_name (en el idioma de los ajustes),
previous_color, previous_color_name.
Los activadores solo se disparan para las estaciones cuyo dispositivo existe, nunca en la primera lectura, y no tras más de un día sin vigilancia (reinicio, Vigicrues inaccesible). Un umbral de altura es una condición de escena sobre la función «Altura del agua», no un activador.
Ejemplos de escenas
- Naranja o rojo cerca de casa: activador «La vigilancia de crecidas sube», color naranja y rojo → enviar el mensaje «Vigilancia {{color_name}} en {{section_name}}: consulte vigicrues.gouv.fr» y poner una lámpara en rojo.
- Fin de la alerta: activador «La vigilancia de crecidas baja», color verde → mensaje «Vuelta al verde en {{section_name}}».
- Umbral de altura: activador «Cambio de estado del dispositivo» sobre «Altura del agua» de su estación, por encima de 3,5 m → enviar un mensaje a toda la casa.
- Estación muda: no hace falta nada, la función «Última medición» lo indica en el panel.
Fuentes de datos, licencia y cuotas
- Vigicrues (
www.vigicrues.gouv.fr/services): la vigilancia de cada tramo (InfoVigiCru.geojson, unos 2,2 MB, publicada al menos dos veces al día), leída cada 30 minutos, y las estaciones de cada tramo (leídas una vez por semana). © VIGICRUES. - Hub'Eau Hydrométrie (
hubeau.eaufrance.fr/api/v2/hydrometrie): las estaciones y sus mediciones en tiempo real, actualizadas cada 5 minutos desde la plataforma hidrométrica nacional y conservadas un mes. Una petición por actualización para todas sus estaciones. - Ambas se publican bajo la Licence Ouverte / Open Licence Etalab 2.0: reutilización libre citando la fuente y su fecha; el widget muestra ambas.
- Ninguno de los dos servicios publica una cuota. La integración es ligera: una petición a Hub'Eau por actualización (cada 15 minutos como mucho), la vigilancia cada 30 minutos, el referencial una vez por semana, y se identifica en sus peticiones. Hub'Eau puede rechazar un uso abusivo: no reduzca estos intervalos.
Solución de problemas
- «Código de estación desconocido»: Hub'Eau no conoce este código. Compruébelo con «Buscar estaciones» o en vigicrues.gouv.fr (el final de la dirección de la página de la estación).
- Sin función de vigilancia: la estación no está en un tramo Vigicrues (muchos ríos pequeños solo se miden), o Vigicrues no respondió al publicar el dispositivo: la integración lo vuelve a intentar cada hora y después la pestaña Descubrir propone actualizar el dispositivo.
- Sin función de caudal: la estación solo mide la altura (Charleville-Mézières, por ejemplo).
- «Sin nueva medición desde…»: la estación ha dejado de enviar datos (mantenimiento, avería, daños de la crecida). Hub'Eau conserva un mes: después, «Sin mediciones desde hace más de un mes».
- «Hub'Eau no responde» o «Vigicrues no responde» en la configuración: el servicio está caído o Gladys no tiene acceso a Internet. Los valores vuelven solos.
- «Alrededor de mi casa» no hace nada: indique la ubicación de su casa en Gladys (Ajustes, Casas); la pantalla de configuración lo indica. Si ha elegido una casa en el ajuste Casa, cuenta la suya: la pantalla de configuración la nombra cuando no tiene ubicación o ya no existe (elija otra o vacíe el campo).
- Registros: tranquilos por defecto (inicio, estación muda o de vuelta, cambio de
vigilancia, fallos una sola vez).
LOG_LEVEL=debugmuestra cada actualización.
Límites
- No es un sistema de alerta de seguridad: solo un complemento, sin garantía de plazo ni de disponibilidad. Prevalecen las instrucciones oficiales.
- La vigilancia cubre solo la Francia metropolitana; los servicios de ultramar de Vigicrues no se leen.
- Las alturas son cotas por encima del cero de la escala de cada estación: no se pueden comparar entre estaciones ni con una altitud.
- Las mediciones en tiempo real son brutas, no validadas: hay valores atípicos.
- Algunas estaciones envían una vez por hora, con hasta unos 75 minutos de retraso.
- Las previsiones de Vigicrues no se leen.
- Probada con respuestas reales de Hub'Eau y Vigicrues grabadas en septiembre y octubre de 2026, todavía no en un Gladys real: sus comentarios son bienvenidos.
- No está afiliada al Estado francés (Vigicrues, SCHAPI) ni a Hub'Eau.
Parámetros de configuración
Estos son los parámetros que Vigicrues 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 sus ríos: por código, por municipio o las más cercanas a su casa. «Buscar estaciones» más abajo las enumera con su río. Guarde y cree los dispositivos en la pestaña Descubrir. |
| Fuentes y límites | section | No | Datos © Vigicrues y Hub'Eau (Licence Ouverte Etalab 2.0), leídos sin cuenta. Un complemento, no un sistema de alerta de seguridad: prevalecen las instrucciones oficiales. Sin afiliación con Vigicrues. |
| Códigos de estación | string | No | Códigos separados por comas, o las direcciones de sus páginas de Vigicrues. |
| Municipios (códigos INSEE) | string | No | Todas las estaciones en servicio de estos municipios, p. ej. 31555 para Toulouse, 75056 para París. |
| Casa | select | No | La casa cuya ubicación usan «Alrededor de mi casa» y «Buscar estaciones». Vacío: la primera casa de Gladys que tiene ubicación. |
| Alrededor de mi casa | select | No | Seguir también las 3 estaciones más cercanas que envían mediciones, como máximo a esta distancia de la ubicación de su casa en Gladys. |
| Intervalo de actualización | select | No | Las estaciones envían una medición cada 5 a 60 minutos. La vigilancia se lee cada 30 minutos. |
| Unidad del caudal | select | No | m³/h: la unidad que Gladys muestra en todas sus pantallas. m³/s: la unidad de Vigicrues, mostrada sin unidad (el nombre de la función la indica). Si la cambia: «Actualice» los dispositivos en la pestaña Descubrir. |
| Idioma de los nombres de las funciones | select | No | Nombres de las funciones de los nuevos dispositivos (Altura del agua, Caudal…) e idioma de sus textos (color, última medición). |
Cómo instalar Vigicrues en Gladys
- En Gladys, abre Integraciones: Vigicrues 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-vigicrues:1.1.0), 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-vigicrues.
Vigicrues requiere Gladys >=5.2.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
Vigicrues 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 externas
- Descubrir las integraciones nativas incluidas en Gladys
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación