Integración domótica NHC Hurricanes, gratuita y de código abierto
Tormentas tropicales y huracanes del National Hurricane Center de EE. UU. cerca de su casa.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Siga en Gladys las tormentas tropicales y los huracanes del National Hurricane Center (NHC, NOAA, Estados Unidos): la cuenca del Atlántico (con el mar Caribe y el golfo), el Pacífico Este y el Pacífico Central (Hawái). Para cada tormenta: su clasificación, su categoría Saffir-Simpson, su viento sostenido, su distancia de su casa, su desplazamiento y las vigilancias y avisos costeros de su último boletín. Para cada cuenca: la probabilidad de que se forme una nueva tormenta en 48 horas y en 7 días, según el Tropical Weather Outlook. Sin cuenta ni clave de API.
No es un servicio de alerta oficial: en caso de peligro, siga las instrucciones de sus autoridades locales y de su servicio meteorológico nacional. Sin afiliación con la NOAA ni con el National Weather Service.
Qué obtiene
- Un dispositivo por cuenca seguida: número de sistemas activos, sistema más fuerte (en palabras), su categoría y su viento sostenido, y la mayor probabilidad de formación en 48 horas y en 7 días.
- Un dispositivo Huracán más cercano: la tormenta más cercana a su casa, su categoría, su viento sostenido, su distancia, su dirección (vista desde su casa) y su desplazamiento, con el historial de la categoría, el viento y la distancia. Sin tormenta, la dirección conserva su último valor.
- Un widget del panel con las tormentas activas, la más fuerte primero, cada una con su boletín y su cono de pronóstico, y la previsión de formación de cada cuenca.
- Cuatro desencadenantes de escena: nueva tormenta con nombre, tormenta dentro del radio alrededor de su casa, categoría elevada (huracán, huracán mayor) y nueva vigilancia o aviso costero.
- Una acción de escena que lee las tormentas activas en una frase, para enviar por mensaje o leer en voz alta.
Junto a la integración GDACS, que clasifica los ciclones de todo el mundo en verde, naranja o rojo según su impacto humanitario, esta da el detalle oficial estadounidense de las tres cuencas del NHC: la categoría Saffir-Simpson, los boletines, las vigilancias y avisos, y la previsión de formación.
Requisitos
- Gladys Assistant 5.1 o posterior.
- Acceso a Internet desde el equipo de Gladys (la integración lee
www.nhc.noaa.gov). - Para las distancias y la tormenta más cercana: la ubicación de su casa en Gladys (Ajustes → Casas), o coordenadas introducidas en la configuración.
Configuración
Instale la integración desde la tienda (o Integraciones → Instalar desde GitHub, con la dirección
https://github.com/guim31/gladys-nhc), guarde la configuración y cree los dispositivos en la pestaña
Descubrir.
Ajustes
| Ajuste | Por defecto | Significado |
|---|---|---|
| Latitud / longitud de la casa | vacías | Déjelas vacías para usar la ubicación de su casa en Gladys. Grados decimales, oeste negativo. |
| Cuencas | las tres | Un dispositivo por cuenca seguida; la tormenta más cercana solo se busca en ellas. |
| Unidades | Imperiales | Imperiales (mph, millas) o métricas (km/h, km), para dispositivos y escenas. |
| Radio | 300 | En millas o kilómetros, según la unidad, para el desencadenante «tormenta dentro del radio». |
| Desencadenantes para | Todas las tormentas de las cuencas seguidas | O solo las tormentas dentro del radio. |
| Intervalo de actualización | 15 minutos | 10, 15, 30 o 60 minutos. |
| Idioma de los textos | Francés | Nombres de los dispositivos y funciones (fijados al crearlos) y textos de las escenas. |
Unidades y nombres
Cambiar las unidades o el idioma modifica los dispositivos: Gladys propone entonces actualizarlos en la pestaña Descubrir. Los nombres de las funciones siguen siendo los de su creación. Los vientos se redondean a 5 mph o 5 km/h, como en los boletines del NHC.
Dispositivos
Dispositivo de cuenca (Huracanes Atlántico, Pacífico Este, Pacífico Central):
| Función | Tipo | Valores |
|---|---|---|
| Sistemas activos | contador | tormentas que sigue el NHC en la cuenca |
| Sistema más fuerte | texto | «Huracán Melissa», o «Ningún sistema activo» |
| Categoría más alta | contador 0-5 | categoría Saffir-Simpson, 0 por debajo de huracán |
| Viento sostenido más fuerte | velocidad (mph o km/h) | 0 sin tormenta |
| Probabilidad de formación 48 h | porcentaje | mayor probabilidad de las perturbaciones de la previsión |
| Probabilidad de formación 7 días | porcentaje | igual, en 7 días |
Fuera de temporada, el NHC deja de publicar su previsión: las probabilidades de formación no se publican entonces (en lugar de un falso 0 %).
Huracán más cercano: tormenta (clasificación y nombre), categoría 0-5, viento sostenido, distancia (millas o km), dirección (grados, 0 norte, 90 este, vista desde su casa) y desplazamiento («Hacia el O a 21 km/h»). Sin tormenta, la tormenta indica «Ningún sistema activo» y la distancia es la mitad de la circunferencia de la Tierra (12 451 millas o 20 038 km), para que una condición «menos de 300 millas» siga siendo falsa. Sin ubicación de su casa, este dispositivo no se actualiza.
La propia integración actualiza los dispositivos (no el sondeo de Gladys).
Widget del panel
Huracanes (NHC): el número de sistemas activos y luego las tormentas de las cuencas seguidas, la más fuerte primero (8 como máximo): clasificación y nombre, viento y distancia, y una insignia con la categoría (roja para un huracán mayor, naranja para un huracán). Toque una tormenta para ver su posición, su desplazamiento, su presión, las vigilancias y avisos costeros vigentes y los enlaces al aviso público y al cono de pronóstico. Debajo, una fila por cuenca con las probabilidades de formación en 48 horas y en 7 días (ajuste Mostrar la previsión de formación para ocultarla), y un enlace al NHC (ajuste Mostrar el enlace al NHC). El widget sigue las unidades del usuario que lo mira.
Desencadenantes de escena
Todos se filtran por cuenca. «Desencadenantes para» elige si los desencadenantes de nueva tormenta, categoría y vigilancia se refieren a todas las tormentas de las cuencas seguidas o solo a las del radio. Con el radio, un nombre, una categoría o una vigilancia anteriores a la entrada de la tormenta en el radio no se señalan después: al entrar solo se dispara tormenta dentro del radio.
- NHC: nueva tormenta con nombre: un sistema se convierte en tormenta tropical (o subtropical) o en huracán y recibe un nombre.
- NHC: tormenta dentro del radio: el centro de una tormenta entra en el radio. Solo vuelve a dispararse después de que la tormenta haya salido del radio en más de un 10 %.
- NHC: categoría elevada: filtro Cambio: se convirtió en huracán, en huracán mayor (categoría 3 o más; prevalece cuando ambos ocurren a la vez), u otro aumento de categoría.
- NHC: vigilancia o aviso costero: el último aviso público de una tormenta pone en vigor un nuevo tipo de vigilancia o aviso: huracán, marejada ciclónica o tormenta tropical, vigilancia o aviso (filtro Vigilancia o aviso). Las zonas son las del boletín, en inglés: compruebe que la suya figura en él. Para las alertas oficiales de su condado, consulte la integración de alertas del NWS.
Variables: identificador, nombre, clasificación (código y en palabras), cuenca, categoría, viento sostenido, distancia de su casa, resumen, enlace al aviso; además el cambio y la categoría anterior, o el tipo de vigilancia y sus zonas.
Las tormentas presentes en el primer arranque, o al guardar la configuración, no disparan nada: no son novedades. Un reinicio tampoco.
Acción de escena
NHC: leer las tormentas actuales devuelve text (una frase: «2 sistemas activos: Huracán Melissa,
categoría 5, 270 km/h, a 230 km al SO de su casa; …», más la mayor probabilidad de formación en 7 días),
count y max_category. Úselos en un mensaje o con la síntesis de voz.
Ejemplos de escenas
- Cuando se dispare NHC: tormenta dentro del radio, envíe
summarya toda la familia. - Cuando se dispare NHC: vigilancia o aviso costero con Aviso de huracán, envíe las
areaspor mensaje. - Cada mañana en temporada, si la categoría del huracán más cercano es mayor que 0, lea las tormentas en voz alta.
Fuentes de datos, condiciones y cuotas
https://www.nhc.noaa.gov/CurrentStorms.json: las tormentas activas.https://www.nhc.noaa.gov/index-at.xml,index-ep.xml,index-cp.xml: el canal de cada cuenca, con el Tropical Weather Outlook y los avisos públicos.
Los datos del National Hurricane Center de la NOAA son de dominio público. No hay cuota publicada: la integración envía 1 petición por ciclo más 1 por cuenca seguida (4 cada 15 minutos por defecto), con un User-Agent que la identifica. La ubicación de su casa nunca se envía: las distancias se calculan en la integración.
Solución de problemas
- «El National Hurricane Center no responde»: el sitio del NHC no es accesible desde el equipo de Gladys; se conservan los valores y la integración lo intenta de nuevo en cada ciclo.
- Sin distancia, sin tormenta más cercana: indique la ubicación de su casa (Ajustes → Casas) o introduzca coordenadas.
- Sin probabilidad de formación: fuera de temporada (de diciembre a mayo) el NHC no publica su previsión.
- Unidades o nombres sin actualizar: actualice los dispositivos en la pestaña Descubrir.
- Registros:
docker logsdel contenedor de la integración;LOG_LEVEL=debugmuestra cada ciclo.
Límites
- Solo tres cuencas: el NHC no cubre el Pacífico occidental (tifones), el océano Índico ni el hemisferio sur: consulte la integración GDACS.
- Las distancias se miden al centro de la tormenta, no al borde de sus vientos.
- Las vigilancias y avisos proceden del texto del boletín, leído tal como se publica; sus zonas están en inglés.
- El NHC actualiza sus boletines cada 6 horas (3 horas cerca de la costa): los valores no son en tiempo real.
Parámetros de configuración
Estos son los parámetros que NHC Hurricanes te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su casa | section | No | Tormentas tropicales y huracanes del National Hurricane Center de EE. UU.: Atlántico, Pacífico Este y Central. Las distancias se calculan en Gladys desde su casa (o coordenadas), nunca se envían. Guarde y cree los dispositivos en la pestaña Descubrir. |
| Fuentes y límites | section | No | Datos del National Hurricane Center de la NOAA (dominio público), leídos sin cuenta. No es un servicio de alerta oficial: siga las instrucciones de sus autoridades locales. Sin afiliación con la NOAA. |
| Latitud de la casa | string | No | Deje ambas coordenadas vacías para usar la ubicación de su casa en Gladys. |
| Longitud de la casa | string | No | Grados decimales, positivos al este (el oeste es negativo). |
| Cuencas | multi_select | No | Un dispositivo por cuenca seguida. La tormenta más cercana solo se busca en estas cuencas. |
| Unidades | select | No | Viento y distancias de los dispositivos y escenas. Cambiarlo pide actualizar los dispositivos en la pestaña Descubrir. |
| Radio | select | No | En millas o kilómetros, según la unidad de arriba. Lo usa el desencadenante «tormenta dentro del radio». |
| Desencadenantes para | select | No | Tormentas a las que se refieren los desencadenantes nueva tormenta, categoría elevada y vigilancia costera. |
| Intervalo de actualización | select | No | El NHC publica un aviso cada 6 horas (3 horas cerca de la costa) y su previsión 4 veces al día. |
| Idioma de los textos | select | No | Nombres de los dispositivos y funciones (al crearlos) y textos enviados a las escenas. |
Cómo instalar NHC Hurricanes en Gladys
- En Gladys, abre Integraciones: NHC Hurricanes 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-nhc: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-nhc.
NHC Hurricanes 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
NHC Hurricanes 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