Integración domótica MeteoAlarm, gratuita y de código abierto

Avisos meteorológicos oficiales de 38 países europeos (MeteoAlarm): nivel, fenómeno, horarios.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.2.0
• ★ 0

Ver en GitHubTodas las integraciones

Los avisos meteorológicos oficiales de 38 países europeos en Gladys: Bélgica, Suiza, Luxemburgo, Alemania, España, Italia, Países Bajos, Irlanda, Austria… y Francia. Los servicios meteorológicos nacionales (IRM, MeteoSuiza, MeteoLux, DWD, AEMET, Met Éireann…) los publican en MeteoAlarm, gestionado por EUMETNET; la integración lee esas fuentes públicas. Sin cuenta ni clave.

Esta integración no está afiliada a EUMETNET ni a MeteoAlarm. Se ha desarrollado sin acceso a la fuente en directo, a partir de muestras reales publicadas: sus comentarios son bienvenidos en el foro de Gladys o en las issues de GitHub.

Qué hace

• Un dispositivo por zona seguida (provincia, cantón, condado, departamento…) y, opcionalmente, uno para una vivienda de Gladys.
• En cada dispositivo: el nivel máximo de alerta vigente (verde, amarillo, naranja, rojo), el nivel por fenómeno (viento, lluvia, tormentas, nieve y hielo, calor, frío, avalanchas, incendios forestales, fenómenos costeros, niebla, inundaciones, lluvia e inundaciones) y los textos: alertas vigentes y próximas, descripción, inicio y fin.
• Un widget del panel que lista las alertas de una zona con su color, su fenómeno, sus horarios y su texto completo.
• Dos disparadores de escena: «Nueva alerta meteorológica» (a menudo la víspera de su inicio) y «Alerta meteorológica finalizada».
• Solo lectura: la integración no controla nada.

Para Francia, la integración Météo-France (otro autor) sigue la vigilancia departamental con más detalle. Esta se dirige sobre todo a los países vecinos y a los trabajadores transfronterizos, con la misma herramienta a ambos lados de la frontera.

Requisitos

• Gladys 5.2.0 o posterior.
• Acceso a Internet desde el equipo de Gladys: las fuentes están en feeds.meteoalarm.org.
• Para seguir una vivienda: una vivienda ubicada en Gladys (Configuración → Viviendas), en un país cuyo servicio meteorológico dé el contorno de sus zonas de aviso (vea Limitaciones).

Configuración

1. Instale la integración: Integraciones → Instalar desde GitHub, dirección https://github.com/guim31/gladys-meteoalarm.
2. En su pestaña Configuración, elija el país.
3. Escriba sus zonas, separadas por comas (10 como máximo): el nombre de la zona tal como aparece en meteoalarm.org (p. ej. Liège, Haute Savoie, Strathclyde), o su código (el EMMA_ID de MeteoAlarm como BE009, o el código nacional de la fuente como FR718). Las tildes, mayúsculas y guiones dan igual, pero el nombre debe ser completo: Savoie no es Haute Savoie.
4. Opcionalmente, elija una vivienda: la integración sigue entonces los avisos cuya zona la contiene.
5. Elija el idioma de los nombres de las funciones y de los textos (francés por defecto) y la consulta (cada 10 o 15 minutos).
6. Guarde y luego añada los dispositivos desde la pestaña Descubrir.

La acción Listar las zonas lee la fuente al momento y lista las zonas conocidas del país con su código, y si se han encontrado las suyas. Una fuente solo lista las zonas que tienen una alerta hoy: la lista crece con cada alerta vista desde la instalación, y «aún no vista» junto a una de sus zonas solo significa que no ha tenido alerta desde entonces. En ese caso, compruebe su ortografía en meteoalarm.org.

El identificador de un dispositivo de zona sale de lo que usted escribe (tildes y mayúsculas ignoradas): escribir BE009 en lugar de Liège crea otro dispositivo.

Consulta y condiciones de uso

• La fuente del país se lee cada 10 o 15 minutos (una petición para todas sus zonas), con If-None-Match / If-Modified-Since: una fuente sin cambios cuesta una respuesta 304.
• El detalle de una alerta (documento CAP: textos, idiomas, contornos de las zonas) se lee una sola vez por versión de la alerta, y solo para las zonas seguidas. Una vivienda necesita el detalle de todas las alertas del país, 40 como máximo por consulta.
• Entre dos lecturas, las horas de inicio y fin se comprueban cada minuto sin ninguna petición: una alerta entra en vigor y termina al minuto.
• La integración no depende de que Gladys consulte sus dispositivos: se actualiza por sí misma.
• MeteoAlarm publica estas fuentes para uso público y no anuncia ningún cupo de peticiones; la integración queda muy por debajo de una petición por minuto, se identifica (User-Agent) y cita su fuente en el widget. Lea las condiciones de uso en meteoalarm.org. Los avisos siguen siendo los de los servicios meteorológicos nacionales: para cualquier decisión, consulte sus canales oficiales.

Dispositivos

Cada zona (o vivienda) da un dispositivo «MeteoAlarm <zona>». Los nombres de las funciones se fijan en el idioma configurado al añadir el dispositivo.

Función	Tipo	Valor
Nivel máximo de alerta	nivel de riesgo	0 verde (sin alerta), 1 amarillo, 2 naranja, 3 rojo
Alerta por viento, Alerta por lluvia…	nivel de riesgo	lo mismo, para un fenómeno (12 funciones)
Alertas vigentes y próximas	texto	«Naranja: Viento (jue, 15 oct, 06:00 → jue, 15 oct, 21:00) · …»
Descripción de la alerta	texto	titular y descripción de la alerta principal
Inicio, Fin de la alerta	texto	su periodo, en la zona horaria de Gladys

Gladys muestra los niveles de riesgo como insignias de color: «Sin riesgo» verde, «Bajo» amarillo, «Medio» naranja, «Alto» rojo — los colores de MeteoAlarm.

Las funciones de nivel solo cuentan las alertas vigentes. Una alerta anunciada para mañana aparece al momento en el texto, en el widget y en el disparador «Nueva alerta meteorológica». La alerta principal es la más alta vigente o, si no hay, la próxima anunciada. Los textos están en el idioma configurado cuando el emisor lo escribe; si no, en inglés; si no, en el idioma del país.

Widget del panel

Añada el widget Alertas meteorológicas a un panel y elija una zona en sus ajustes. Muestra el nivel máximo y luego las alertas vigentes (la más alta primero) y las anunciadas, cada una con su color, fenómeno y periodo. Al tocar una alerta se abre su texto completo: titular, descripción y recomendaciones del servicio meteorológico. Los textos siguen el idioma del panel cuando el emisor lo escribe. La última línea cita la fuente, o indica que MeteoAlarm no responde y que las alertas mostradas pueden estar desactualizadas.

Disparadores de escena

En el editor de escenas (categoría Integraciones):

• Nueva alerta meteorológica: aparece una alerta en una zona o sube su nivel (viento amarillo y luego viento naranja: anunciado dos veces; un nivel más bajo no es noticia). A menudo se dispara la víspera del inicio. Filtros: la zona, los niveles (amarillo, naranja, rojo), los fenómenos. Variables: {{triggerEvent.data.zone}}, level (yellow, orange, red), level_label, phenomenon, phenomenon_label, in_force (verdadero si ya está vigente), period (en palabras), onset y expires (fechas ISO), headline, description, instruction.
• Alerta meteorológica finalizada: una zona ya no tiene alerta para un fenómeno, terminada o retirada. Filtros: la zona, los fenómenos. Variables: zone, level, level_label (el último nivel), phenomenon, phenomenon_label.

La primera lectura tras la instalación es silenciosa (instalar en plena tormenta no lanza todas las escenas a la vez), y un reinicio no vuelve a anunciar lo ya anunciado. Para actuar sobre un nivel vigente, use el disparador habitual «valor de un dispositivo» sobre las funciones de nivel.

Ejemplos de escenas

• Viento anunciado: disparador «Nueva alerta meteorológica», niveles naranja y rojo, fenómeno viento → enviar el mensaje «Alerta {{triggerEvent.data.level_label}}, {{triggerEvent.data.phenomenon_label}}: {{triggerEvent.data.period}}. {{triggerEvent.data.headline}}».
• Naranja o rojo vigente: disparador «valor de un dispositivo» sobre «Nivel máximo de alerta» de su zona, mayor o igual que 2 → poner la lámpara de la entrada en naranja; otra escena en 0 la apaga.
• Calor: «Alerta por calor» mayor o igual que 1 → cerrar las persianas del lado sur a las 11:00 mientras dure.
• Fin de la alerta: disparador «Alerta meteorológica finalizada» → enviar «La alerta {{triggerEvent.data.phenomenon_label}} ha terminado en {{triggerEvent.data.zone}}».

Solución de problemas

• «Elija el país de sus zonas» / «Introduzca al menos una zona»: la configuración está incompleta.
• «MeteoAlarm no tiene ninguna fuente para este país»: la dirección de la fuente respondió 404. Avísenos: puede que MeteoAlarm la haya cambiado.
• «MeteoAlarm no responde»: red o servicio caídos. La última lectura se mantiene y la integración lo reintenta en cada consulta; los registros lo dicen una vez, y otra cuando vuelve a responder.
• Una zona sigue en verde mientras meteoalarm.org muestra una alerta: ejecute Listar las zonas y compare la ortografía, o escriba el código que aparece allí.
• Sin descripción, solo el título: no se pudo leer el detalle de la alerta; se reintenta tras la siguiente lectura de la fuente.
• «La fuente de este país no da el contorno de las zonas»: no se puede ubicar la vivienda; siga zonas.
• La vivienda no tiene ubicación: indíquela en Configuración → Viviendas.
• Registros detallados: inicie la integración con LOG_LEVEL=debug. Un ciclo normal no escribe nada en el nivel info.

Limitaciones

• Desarrollada sin acceso a la fuente en directo (el entorno de desarrollo no podía alcanzarla): probada con fuentes reales publicadas con la biblioteca meteoalert-api (Francia, Irlanda, Reino Unido, 2022) y con una fuente belga sintética. La lista de países sigue las direcciones que usa esa biblioteca. Sus comentarios son bienvenidos.
• Una fuente solo lista las zonas que tienen alerta: no existe una lista completa de las zonas de un país, de ahí los nombres y códigos que hay que escribir.
• El seguimiento de una vivienda solo funciona si el servicio meteorológico da el contorno de sus zonas en el detalle de los avisos (Irlanda lo hace; Francia y el Reino Unido no lo hacían en las muestras).
• Un país por instalación, 10 zonas como máximo.
• Los textos son los de los servicios meteorológicos: su idioma depende del emisor.
• MeteoAlarm califica esta fuente Atom de «legacy»: si se retira, la integración tendrá que adaptarse.
• No es un sistema de alerta oficial: para cualquier decisión, consulte el servicio meteorológico nacional.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Alertas MeteoAlarm	section	No	Sigue los avisos oficiales que los servicios meteorológicos de 38 países publican en MeteoAlarm (EUMETNET): un dispositivo por zona, consultado cada 10 o 15 minutos. No se necesita cuenta. Elija el país y escriba sus zonas como aparecen en meteoalarm.org, o su código; la acción «Listar las zonas» muestra las zonas que conoce la fuente. Para Francia, la integración Météo-France es más detallada. Sin relación con EUMETNET ni MeteoAlarm.
País	select	Sí
Zonas	string	No	Nombres o códigos de las zonas, separados por comas (10 como máximo): un dispositivo cada una. Da igual tildes y mayúsculas.
Vivienda (opcional)	select	No	Sigue también los avisos cuya zona contiene esta vivienda. Solo funciona si el emisor da el contorno de sus zonas: vea la documentación.
Idioma	select	No	Nombres de las funciones y textos enviados a Gladys. Los textos de los avisos la siguen si el emisor la escribe; si no, inglés.
Consulta	select	No	Frecuencia de lectura de la fuente MeteoAlarm. Las horas de inicio y fin se siguen al minuto en todo caso.

Cómo instalar MeteoAlarm en Gladys

1. En Gladys, abre Integraciones: MeteoAlarm 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-meteoalarm: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).
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-meteoalarm.

MeteoAlarm 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

MeteoAlarm 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 🙂