Integración domótica NWPS River Floods, gratuita y de código abierto

Nivel de los ríos de EE. UU., categorías de inundación y previsiones de cresta del NWS (NOAA).
Lleva a Gladys el nivel de los ríos de Estados Unidos, su categoría de inundación y la previsión oficial de la cresta del National Weather Service de la NOAA, desde la API pública del National Water Prediction Service (NWPS, sucesor de AHPS). Sin cuenta, sin clave.
Es un complemento, no es 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 un servicio público. En caso de inundación, siga los avisos oficiales (weather.gov, la protección civil local, el 911). Esta integración no está afiliada a la NOAA ni al National Weather Service. Probada con la API real del NWPS, todavía no en una instalación real de Gladys: sus comentarios son bienvenidos.
Lo que obtiene
- Un dispositivo por estación que sigue: el nivel del agua en pies o metros, el caudal cuando la estación mide uno, la categoría de inundación del NWS (sin inundación, nivel de acción, inundación menor, moderada, mayor) como nivel de riesgo y en palabras, y la hora de la última medición.
- En las estaciones que el NWS prevé (puntos de previsión), la cresta prevista: el valor más alto de la previsión vigente, su hora y su categoría de inundación.
- Lo que no dan las estaciones del USGS ya presentes en la tienda: los umbrales de inundación del NWS y sus previsiones. Las mediciones suelen venir del USGS: el NWPS las retransmite.
- Un disparador de escena «La categoría de inundación sube», para una subida observada o prevista.
- Un widget del panel: sus estaciones con su nivel y su categoría, o una estación con su cresta prevista.
- Un botón «Buscar estaciones» que enumera las estaciones alrededor de su casa.
Requisitos
- Gladys Assistant 5.3.2 o posterior (la unidad m³/s del caudal en unidades métricas).
- Acceso a Internet desde Gladys: la integración lee
api.water.noaa.gov. - Para «Alrededor de mi casa» y «Buscar estaciones»: la ubicación de su casa en Gladys (Ajustes, Casas). Con varias casas, elija la suya en el ajuste Casa. La integración la pide en la instalación (permiso «ubicación»); solo sirve para encontrar las estaciones cercanas, se redondea a unos 5 km antes de salir de Gladys y nunca se guarda ni se registra.
- Estados Unidos (y las pocas estaciones del NWS en Puerto Rico y en las fronteras).
Configuración
Ajustes
| Ajuste | Efecto |
|---|---|
| Códigos de estación | Códigos NWS (cuatro letras y una cifra) separados por comas, BRKM2, ARCF1, o las direcciones de sus páginas, https://water.noaa.gov/gauges/brkm2. |
| 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 en servicio más cercanas, a 5, 10 o 25 millas de su casa. Desactivado por defecto. |
| Unidades | Pies, cfs (por defecto, las unidades del NWS) o metros, m³/s, para los nuevos dispositivos. |
| Intervalo de actualización | 15 (por defecto), 20 o 30 minutos. |
| Idioma de los nombres de las funciones | Nombres de las funciones de los nuevos dispositivos, idioma de sus textos y de las variables de escena. Francés por defecto. |
Se siguen como máximo 20 estaciones. Guarde, abra la pestaña Descubrir y cree los dispositivos que desee. Una estación cuyo dispositivo ha creado sigue activa aunque quite su código de los ajustes: elimine el dispositivo para detenerla.
Cambiar las unidades no cambia los dispositivos ya creados: sus funciones conservan la unidad con la que se crearon, y los valores la siguen. Pulse Actualizar en un dispositivo de la pestaña Descubrir para cambiarlo (su historial mezcla entonces ambas unidades).
Encontrar sus estaciones
El botón Buscar estaciones enumera las estaciones en servicio alrededor de la casa elegida en los ajustes (25 millas, o la distancia elegida), la más cercana primero, con su código, su distancia, su categoría actual y «previsión» cuando el NWS las prevé. Copie los códigos que desee en Códigos de estación y guarde. El código de una estación también aparece en su página de water.noaa.gov.
Dispositivos
Un dispositivo por estación, con el nombre que le da el NWS («Potomac River near Washington DC
(Little Falls)»), con el código como NWS_LID y el estado como STATE en sus parámetros. Sus
funciones son de solo lectura:
| Función | Tipo (Gladys) | Valor |
|---|---|---|
| Nivel del agua | Profundidad de líquido | Nivel en la estación, en pies o metros, sobre el cero de la escala (una altitud en algunos lagos y presas). |
| Caudal (cfs) / Caudal | Caudal de agua | Cuando la estación mide uno: en pies cúbicos por segundo (unidad que Gladys no tiene: el nombre la indica) o m³/s. |
| Nivel de inundación | Riesgo | Cuando la estación tiene umbrales: 0 sin inundación (nivel de acción incluido), 1 menor, 2 moderada, 3 mayor. |
| Categoría de inundación | Texto | La categoría en palabras: Sin inundación, Nivel de acción, Inundación menor… o por qué no hay ninguna. |
| Última medición | Texto | Hora de la última medición, en la zona horaria de Gladys. |
| Cresta prevista | Profundidad de líquido o caudal | Solo puntos de previsión: el valor más alto de la previsión vigente (un caudal en las pocas estaciones previstas por caudal). |
| Hora de la cresta prevista | Texto | Su hora, o «Sin previsión vigente». |
| Nivel de inundación previsto | Riesgo | El nivel de inundación de la cresta, 0 sin previsión vigente. |
| Categoría prevista | Texto | La categoría de la cresta en palabras. |
Una medición de más de 24 horas no se vuelve a enviar: el nivel muestra entonces «sin valor reciente» en Gladys, y la categoría «Sin medición reciente».
Cuando se retira una previsión, la cresta prevista conserva su último valor: su hora y su categoría indican entonces «Sin previsión vigente», y su nivel de inundación 0.
Categorías de inundación
El NWS define, para cada punto de previsión y muchas otras estaciones, un nivel de acción (momento de prepararse, aún sin desbordamiento) y los umbrales de inundación menor, moderada y mayor, según los daños de inundaciones pasadas. La integración publica la categoría que calcula el NWS: no compara los niveles por sí misma. Una estación sin umbrales («Sin umbrales de inundación») no tiene función de nivel de inundación. Muchos puntos de previsión solo se prevén en aguas altas: entre dos episodios, su previsión indica «Sin previsión vigente».
Widget del panel
Añada el widget Estaciones fluviales a un panel:
- sin estación elegida: una línea por estación con su nivel y su categoría, en verde (sin inundación), amarillo (nivel de acción, menor) o rojo (moderada, mayor), y un título cuando una estación está inundada o se prevé que lo esté;
- con una estación elegida: sus mosaicos de nivel y caudal, su categoría, la cresta prevista con su hora y su categoría, su umbral de inundación y su última medición.
Los niveles de las líneas siguen las unidades de su perfil de Gladys; los mosaicos muestran la unidad de las funciones. El botón water.noaa.gov abre la página de la estación; un ajuste lo oculta.
Disparadores de escena
La categoría de inundación sube se dispara cuando la categoría de una estación creada sube a
nivel de acción, inundación menor, moderada o mayor, observada o prevista. Filtros: la estación,
observada o prevista, la nueva categoría. Variables para sus mensajes: gauge_name,
category_name, source_name (observada o prevista), value (el valor con su unidad) y time
(de la medición o de la cresta), en el idioma de la configuración.
Se dispara una vez por subida: de nuevo solo después de una bajada, o después de retirarse la previsión. Las últimas categorías se
guardan en /data: una subida durante un reinicio se dispara una vez, y la primera medición de una
nueva estación no dispara nada.
Para un umbral propio, use el disparador nativo de Gladys sobre un valor del dispositivo: «Nivel de inundación mayor o igual que 1» (inundación menor), o «Cresta prevista por encima de 9 ft».
Ejemplos de escenas
- Inundación prevista: disparador «La categoría de inundación sube», prevista, menor, moderada o mayor → enviar el mensaje «{{gauge_name}}: {{category_name}} prevista, cresta {{value}} a las {{time}}».
- Inundación menor observada: disparador sobre el valor «Nivel de inundación ≥ 1» → avisar y encender una luz de alerta.
- Vuelta a la normalidad: disparador sobre el valor «Nivel de inundación = 0» → enviar «El río ha vuelto por debajo del umbral de inundación».
Fuente de datos, cuotas y licencia
- Fuente: el National Water Prediction Service del National Weather Service de la NOAA,
https://api.water.noaa.gov/nwps/v1/(/gauges/{lid}para cada estación,/gauges?bbox…para las estaciones alrededor de la casa). Datos del gobierno de EE. UU., dominio público; crédito: NOAA / NWS. - Sin cuenta, sin clave, sin cuota publicada. La integración consulta cada estación seguida una vez por actualización (cada 15 minutos por defecto, 20 estaciones como máximo), una tras otra, con un User-Agent que la identifica, y busca las estaciones alrededor de la casa una vez al día.
- Las mediciones de muchas estaciones vienen del USGS y de otros socios, retransmitidas por el NWPS.
Solución de problemas
- «Códigos de estación desconocidos»: un código de los ajustes no es una estación del NWS. Compruébelo en water.noaa.gov, o use Buscar estaciones. Un número de sitio del USGS (8 cifras) no es un código NWS.
- «La API del NWPS no responde»: Gladys no alcanza
api.water.noaa.gov, o el servicio está caído. La integración lo reintenta en cada actualización, y el estado vuelve solo. - «Ninguna casa de Gladys tiene ubicación»: configure la ubicación de su casa en Ajustes, Casas, o desactive «Alrededor de mi casa».
- Sin cresta prevista: la estación no es un punto de previsión, o el NWS no tiene previsión vigente para ella (habitual fuera de las aguas altas).
- Valores antiguos: la última medición aparece en «Última medición». Una estación que ya no mide indica «Sin medición reciente».
- Registros: Integraciones → NWPS River Floods → registros;
LOG_LEVEL=debugmuestra cada actualización.
Límites
- Un complemento, no un sistema de alerta de seguridad: prevalecen los avisos del NWS y sus autoridades locales.
- El NWPS da la cresta de la previsión, no toda la curva prevista ni su incertidumbre.
- Las categorías de inundación solo existen donde el NWS ha definido umbrales.
- El caudal en cfs no tiene unidad en Gladys (el nombre indica «cfs»); en unidades métricas está en m³/s.
- Desarrollada y probada con la API real del NWPS, sin una instalación real de Gladys: sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que NWPS River Floods te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Sus estaciones | section | No | Siga las estaciones fluviales del National Weather Service: 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 del National Weather Service de la NOAA (dominio público), leídos sin cuenta. Un complemento, no un sistema de alerta de seguridad: prevalecen los avisos oficiales. Sin afiliación con la NOAA ni el NWS. |
| Códigos de estación | string | No | Códigos NWS separados por comas, o las direcciones de sus páginas en water.noaa.gov. |
| 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 en servicio más cercanas, a esta distancia de su casa. |
| Unidades | select | No | Unidades de los nuevos dispositivos. Para cambiarlas: «Actualizar» los dispositivos en la pestaña Descubrir. |
| Intervalo de actualización | select | No | Las estaciones miden cada 5 a 60 minutos, las previsiones se emiten unas veces al día. |
| Idioma de los nombres de las funciones | select | No | Nombres de las funciones de los nuevos dispositivos, e idioma de sus textos (categoría, horas) y de las variables de escena. |
Cómo instalar NWPS River Floods en Gladys
- En Gladys, abre Integraciones: NWPS River Floods 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-nwps: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). - 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-nwps.
NWPS River Floods requiere Gladys >=5.3.2. 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
NWPS River Floods 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