Integración domótica Environment Agency Flood, gratuita y de código abierto

Niveles de los ríos y avisos de inundación en Inglaterra, de la Environment Agency.

• Publicado por guim31
• Dispositivos
• Versión 1.0.0
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Lleva a Gladys los niveles del agua de los ríos, las mareas y los acuíferos de Inglaterra (unas 4.000 estaciones: el Támesis, el Severn, el Trent, la costa…) y los avisos de inundación en vigor alrededor de su casa, desde la API de vigilancia de crecidas en tiempo real de la Environment Agency. Sin cuenta ni clave.

No es un servicio de alerta de crecidas. 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 un servicio público. En caso de crecida, siga los avisos oficiales: suscríbase a los avisos gratuitos de la Environment Agency, consulte Check for flooding o llame a Floodline al 0345 988 1188; llame al 999 si hay vidas en peligro. Integración sin afiliación con la Environment Agency.

Lo que obtiene

• Un dispositivo por estación seguida: el nivel del agua en metros, su estado respecto al rango habitual de la estación (bajo, normal, alto), el nivel más alto reciente, el caudal en m³/s cuando la estación lo mide, y la fecha de la última medición.
• Un dispositivo «Alertas de crecidas» para la zona alrededor de su casa: el nivel del aviso más grave en vigor (ninguno, alerta, aviso, aviso grave de inundación), el número de avisos en vigor y el último, en texto.
• Una estación que deja de enviar se muestra como tal («Sin nueva medición desde…»): un valor antiguo nunca se vuelve a enviar como si fuera reciente.
• Cuatro disparadores de escena: se emite o se agrava un aviso de inundación, se levanta un aviso de inundación, cambia el estado de una estación (bajo, normal, alto), se cruza un nivel de referencia (rango habitual, nivel más alto reciente, récord).
• Un widget de panel: los avisos en vigor alrededor de su casa y, después, sus estaciones, su nivel, su tendencia (sube, estable, baja) y su estado.
• Un botón «Buscar estaciones» que enumera las estaciones alrededor de su casa, por nombre, río o ciudad, o por referencia, con su nivel actual.

Requisitos

• Gladys Assistant 5.1.0 o posterior.
• Acceso a Internet desde Gladys: la integración lee environment.data.gov.uk.
• Para los avisos de inundación y «Estaciones alrededor de mi casa»: la ubicación de su casa en Gladys (Ajustes, Casas). La integración la pide en la instalación (permiso «ubicación»). Solo se usa dentro del contenedor para elegir las estaciones y zonas más cercanas: nunca se envía a la Environment Agency, nunca se guarda ni se registra.
• Solo Inglaterra: Gales, Escocia e Irlanda del Norte tienen sus propios servicios.

Configuración

Ajustes

Ajuste	Efecto
Estaciones	Referencias o nombres de estaciones, separados por comas: 3400TH, Bewdley, E71539. La dirección de una página de estación de «Check for flooding» también sirve.
Estaciones alrededor de mi casa	Sigue también las 3 estaciones más cercanas que envían mediciones, a 10, 20 o 50 km de su casa como máximo.
Avisos de inundación alrededor de mi casa	Crea el dispositivo «Alertas de crecidas», para las zonas cuyo centro está a 5, 10 (por defecto), 20 o 50 km de su casa. «No» lo retira de los dispositivos descubiertos.
Intervalo de actualización	15, 20 o 30 minutos. Una solicitud cubre todas las estaciones, otra los avisos.
Idioma de los nombres de las funciones	Nombres de las funciones de los nuevos dispositivos (Nivel del agua, Caudal…) e idioma de los textos («Última medición», «Última alerta») y de las variables de escena.

Guarde, abra la pestaña Descubrir de la integración y cree los dispositivos que desee. Una estación seguida lo sigue siendo mientras exista su dispositivo, aunque la quite de la configuración.

Encontrar sus estaciones

Pulse «Buscar estaciones» en la configuración. Deje el campo vacío para listar las estaciones alrededor de su casa (10 km, o la distancia elegida), o escriba:

• un nombre de estación: Kingston, Bewdley (se ignoran mayúsculas y acentos);
• un río o una ciudad: Severn, Shrewsbury (las 10 más cercanas, o las 10 primeras por río);
• ambos: Thames Windsor;
• una referencia de estación: 3400TH, o la dirección de su página de «Check for flooding».

Cada línea da la referencia, el nombre, el río y la ciudad, la distancia a su casa y el nivel actual, o «sin medición reciente». Copie las referencias en «Estaciones» y guarde.

Dispositivos

Estaciones

Función	Tipo en Gladys	Valor
Nivel del agua	Profundidad líquida (m)	El nivel de la estación, en metros (véase más abajo).
Estado del nivel (rango habitual)	Estado del nivel líquido	Bajo por debajo del rango habitual de la estación, Alto por encima, Normal dentro.
Nivel más alto reciente	Profundidad líquida (m)	El nivel más alto de los últimos años, una referencia para el gráfico del historial.
Caudal (m³/s)	Caudal de agua	En m³/s (Gladys no tiene la unidad m³/s: el nombre lo indica), cuando la estación lo mide.
Última medición	Texto	Fecha de la última medición, o «Sin nueva medición desde…».

Una función solo existe si la estación la proporciona. El nivel del agua no es una profundidad: en un río es la cota sobre el cero de la escala de la estación (mASD); en las estaciones de marea y de acuífero, una altura sobre el nivel del mar (mAOD, Ordnance Datum): el parámetro LEVEL_DATUM del dispositivo lo indica. Compárelo con el rango habitual de la misma estación (visible en su página de «Check for flooding»), no con otra estación. Los parámetros del dispositivo contienen la referencia de la estación, su identificador RLOI (el número de su página de «Check for flooding»), su río y su ciudad.

El nivel y el caudal son funciones numéricas: las escenas de Gladys ya pueden compararlos con cualquier valor propio («Nivel del agua por encima de 4,8 m»).

Alertas de crecidas

Función	Tipo en Gladys	Valor
Nivel de alerta de crecidas	Nivel de riesgo	0 ninguno, 1 alerta, 2 aviso, 3 aviso grave de inundación: el más grave en vigor.
Alertas en vigor	Contador	Las alertas y los avisos en vigor alrededor de su casa.
Última alerta	Texto	«Aviso de inundación: Lyme Brook at Newcastle under Lyme (23/10, 13:41)», o ninguno en vigor.

La Environment Agency emite tres niveles: flood alert, aquí «alerta de inundación» (es posible una inundación, prepárese), flood warning, «aviso de inundación» (se espera una inundación, actúe ya) y severe flood warning, «aviso grave de inundación» (peligro para la vida). Un aviso está «alrededor de su casa» cuando el centro de su zona está a la distancia elegida: una zona grande puede cubrir su casa con un centro más lejano; en caso de duda, elija 20 km.

Widget de panel

Añada el widget Crecidas en Inglaterra a un panel.

• Sin ajuste: un título con el aviso más grave en vigor, una línea por aviso alrededor de su casa (4 como máximo, o «Ninguna en vigor») y, después, una línea por estación seguida con su nivel y su tendencia, coloreada según su estado: azul bajo, verde normal, rojo alto, gris sin rango habitual o sin medición reciente.
• Con una estación elegida: su nivel y su caudal en directo, después su estado, su nivel más alto reciente, su tendencia y su última medición, y un enlace a su página de «Check for flooding».
• Con las alertas de crecidas elegidas: todos los avisos en vigor alrededor de su casa.

Disparadores de escena

Disparador	Filtros	Variables
Aviso de inundación emitido o agravado	Nivel (severe, warning, alert)	Nivel y nivel anterior (código y texto), código y nombre de la zona, río o mar, condado, mensaje, emitido el
Aviso de inundación levantado	Nivel que tenía	Nivel (código y texto), código y nombre de la zona, río o mar, condado
El estado del nivel cambia	Estación, nuevo estado (low, normal, high)	Nombre de la estación, río, nivel, estado, estado anterior (código y texto)
Nivel de referencia cruzado	Estación, nivel, sentido (rising, falling)	Nombre de la estación, río, nivel, código y nombre del nivel de referencia, su valor, sentido

«Emitido o agravado» se dispara con un aviso nuevo alrededor de su casa y con un aviso que se agrava (una alerta convertida en aviso). «Levantado» se dispara cuando un aviso deja de estar en vigor o falta en el flujo dos lecturas seguidas (un fallo del flujo no levanta nada); cambiar la distancia no dispara nada. Los niveles de referencia ofrecidos son los límites inferior y superior del rango habitual, el nivel más alto reciente y el nivel más alto registrado; una estación solo dispara los que tiene. La bajada cuenta cuando el nivel está 2 cm por debajo de la referencia, y solo entonces puede contar una nueva subida: un nivel que oscila a su alrededor dispara una sola vez.

Los disparadores solo actúan para un dispositivo que usted haya creado (la estación, o «Alertas de crecidas»), con datos recientes, y no después de un reinicio de más de un día. La primera lectura tras la instalación no dispara nada: los avisos ya en vigor los muestran el dispositivo y el widget.

Ejemplos de escenas

• Aviso de inundación en casa: «Aviso de inundación emitido o agravado», niveles warning y severe → enviar un mensaje «{{severity_name}}: {{area_name}}. {{message}}», encender la luz de la entrada y apagar los enchufes del sótano.
• Fin del aviso: «Aviso de inundación levantado» → mensaje «Levantado: {{area_name}}».
• El río sube: «El estado del nivel cambia», su estación, nuevo estado Alto → avisar a la familia para mover el coche.
• Nuevo récord: «Nivel de referencia cruzado», nivel «Nivel más alto reciente», sube por encima → mensaje «{{station_name}}: {{height}} m, por encima del {{mark_name}}».

Fuentes, licencia y cuotas

• Datos: Environment Agency, API de vigilancia de crecidas en tiempo real, licencia Open Government Licence v3.0 («Contains public sector information licensed under the Open Government Licence v3.0»; el widget cita la fuente).
• Las mediciones son casi en tiempo real y sin verificar: pueden corregirse más tarde. Las estaciones envían cada 15 minutos, algunas con menos frecuencia; los avisos se actualizan cada 15 minutos.
• Sin cuenta, sin clave, sin cuota documentada. La integración es ligera: una solicitud por actualización para las últimas mediciones de todas las estaciones seguidas y una para los avisos en vigor en Inglaterra (15 minutos por defecto, nunca más rápido), el detalle de cada estación una vez al día, la lista de estaciones (unos 4 MB) y la de zonas (unos 3 MB) una vez por semana y solo si hace falta.

Solución de problemas

• «Estación desconocida»: compruebe la ortografía o use «Buscar estaciones» y copie la referencia.
• «La Environment Agency no responde»: el servicio o su acceso a Internet no funciona; los valores vuelven solos.
• «Alrededor de mi casa» no añade nada, o no hay dispositivo «Alertas de crecidas»: indique la ubicación de su casa (Ajustes, Casas) o elija una distancia mayor.
• No hay función de estado: la estación no tiene rango habitual. Las estaciones de marea nunca lo tienen aquí: la marea lo cruza dos veces al día.
• «Sin nueva medición desde…»: la estación envía con retraso o ya no envía; algunas envían sus valores por lotes, con unas horas de retraso.
• Falta un aviso que recibo: el centro de su zona está más lejos que la distancia elegida: elija una mayor.
• Registros: en Gladys, los registros de la integración; LOG_LEVEL=debug muestra cada ciclo.

Límites

• No hace falta ningún equipo; probada contra el servicio real y contra respuestas grabadas, pero aún no en una instalación real de Gladys: sus comentarios son bienvenidos.
• Solo Inglaterra y solo lo que publica la Environment Agency: sin previsiones, sin avisos de aguas superficiales o subterráneas emitidos por otros organismos.
• La distancia de un aviso se mide al centro de su zona, no a su contorno.
• 20 estaciones como máximo desde la configuración (más aquellas cuyo dispositivo haya creado).
• Los nombres de las funciones se fijan al crear el dispositivo: cambiar el idioma después solo cambia los textos enviados a partir de entonces.

Parámetros de configuración

Estos son los parámetros que Environment Agency Flood te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Sus estaciones y avisos de inundación	section	No	Siga los niveles del agua de las estaciones de la Environment Agency en Inglaterra, por referencia, nombre o cerca de su casa, y los avisos de inundación a su alrededor. «Buscar estaciones» las enumera. Guarde y cree los dispositivos en la pestaña Descubrir.
Fuentes y límites	section	No	Datos: API de vigilancia de crecidas en tiempo real de la Environment Agency, Open Government Licence v3.0, leídos sin cuenta. Solo Inglaterra. No es un servicio de alerta de crecidas: confíe en los avisos oficiales (Floodline 0345 988 1188). Sin afiliación con la Environment Agency.
Estaciones	string	No	Referencias o nombres de estaciones, separados por comas.
Estaciones 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.
Avisos de inundación alrededor de mi casa	select	No	Un dispositivo «Alertas de crecidas» sigue los avisos cuya zona tiene su centro como máximo a esta distancia de su casa.
Intervalo de actualización	select	No	Las estaciones envían una medición cada 15 minutos y los avisos se actualizan cada 15 minutos. Una sola solicitud cubre todas las estaciones.
Idioma de los nombres de las funciones	select	No	Nombres de las funciones de los nuevos dispositivos (Nivel del agua, Caudal…) e idioma de sus textos y de las variables de escena.

Cómo instalar Environment Agency Flood en Gladys

1. En Gladys, abre Integraciones: Environment Agency Flood aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-ea-flood:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-ea-flood.

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

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

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂