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

Observaciones, previsiones y avisos meteorológicos oficiales para Finlandia, datos abiertos del FMI.

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

Ver en GitHubTodas las integraciones

El tiempo de Finlandia en Gladys, del Instituto Meteorológico de Finlandia (FMI, Ilmatieteen laitos): las mediciones de la estación meteorológica más cercana, la previsión editada por sus meteorólogos (hora a hora durante unos 9 días) y sus avisos meteorológicos oficiales. Datos abiertos: sin cuenta ni clave API.

Fuente: Finnish Meteorological Institute, datos bajo licencia CC BY 4.0. Esta integración es un proyecto comunitario, sin relación con el FMI.

Lo que obtiene

• El widget del tiempo de Gladys y el asistente de chat usan el FMI: el tiempo actual medido por la estación del FMI más cercana (temperatura, humedad, presión, punto de rocío, viento y ráfagas, nubosidad), completado por la previsión para lo que la estación no mide, la salida y la puesta del sol, las próximas 24 horas con la precipitación de cada hora y su probabilidad, y los próximos 8 días. El día y la noche tienen sus propios iconos. Todo se muestra en °C, m/s y mm o en °F, mph y pulgadas, según el sistema de unidades de cada usuario de Gladys.
• Los avisos del FMI para su zona (amarillo, naranja, rojo: viento, lluvia, tormentas, bajas o altas temperaturas, incendios forestales, condiciones de tráfico, seguridad de los peatones, UV, nivel del mar), mostrados como alertas en el widget del tiempo, vigentes o anunciados. El disparador de escena alerta meteorológica integrado en Gladys funciona con ellos, y se activa en el minuto siguiente a un cambio.
• Disparador de escena «Aviso del FMI modificado»: un aviso emitido, elevado, rebajado, actualizado o levantado, con su color y una frase en su idioma.
• Disparador de escena «Lluvia o nieve prevista en la próxima hora».
• Acción de escena «Obtener la precipitación de la próxima hora».
• Acción de escena «Obtener la previsión del día» (hoy o mañana).
• Acción de escena «Obtener los avisos del FMI»: el nivel más alto para su vivienda, para condicionar una escena.

Ningún widget adicional: el widget del tiempo de Gladys ya muestra el tiempo actual, la previsión y los avisos.

Solo para Finlandia. La previsión del FMI cubre Finlandia y los países nórdicos vecinos, sus estaciones y sus avisos Finlandia; en otros lugares no hay previsión y Gladys usa otro proveedor meteorológico. Para una previsión mundial, instale MET Norway en su lugar: también cubre Finlandia, pero sin las estaciones ni los avisos finlandeses.

Instalación

1. Compruebe que su vivienda tiene una ubicación en Gladys: Configuración → Viviendas, luego la dirección o la posición en el mapa. La integración actualiza el tiempo de cada vivienda que tenga una.
2. Instale FMI desde la tienda de integraciones (o Integraciones → Instalar desde GitHub con la dirección https://github.com/guim31/gladys-fmi). Gladys le pide que autorice el acceso a la ubicación de sus viviendas: la integración encuentra así su estación más cercana y sus avisos, y vigila la lluvia de la próxima hora.
3. Abra la pestaña Configuración y haga clic en Probar FMI. La respuesta indica la temperatura actual de su primera vivienda, la estación que la midió y sus avisos.

Eso es todo: el widget del tiempo de su panel muestra ahora el FMI. Si hay otra integración meteorológica instalada, elija el proveedor en los ajustes del widget del tiempo.

Se necesita Gladys 5.2 o posterior.

Configuración

Nada es obligatorio.

• Unidades de los valores de escena — las unidades de las temperaturas, el viento y la precipitación que la integración pone en las variables de escena. Automático sigue el sistema de unidades del último usuario que consultó el tiempo; elija Métrico o EE. UU. para fijarlo. El widget del tiempo sigue siempre la preferencia de cada usuario.
• Idioma de los textos de escena — el idioma de las frases que la integración pone en las variables de escena («Aviso naranja por viento emitido para Uusimaa…»): inglés, francés, alemán o español. Francés por defecto; Automático sigue el idioma de su Gladys. Los textos del propio FMI (titular, detalles, zona) están en inglés.

Frecuencia de actualización y condiciones del FMI

El FMI publica sus datos libremente, con límites (20 000 solicitudes al día y 600 cada 5 minutos por usuario). La integración se mantiene muy por debajo:

• actualiza cada 30 minutos aproximadamente, más unos minutos al azar para que todos los Gladys no llamen en el mismo segundo;
• por vivienda, hace una solicitud de previsión y una de observaciones (las viviendas en el mismo lugar las comparten), y una solicitud de avisos para todas: unas 150 solicitudes al día para una vivienda. Alimentan todo: el panel, el chat y las escenas. Abrir el panel no cuesta nada: Gladys se sirve desde la memoria;
• envía coordenadas redondeadas a 4 decimales (unos 10 m) y una identificación de la aplicación (gladys-fmi/<version> github.com/guim31/gladys-fmi);
• se pone en pausa si el FMI pide reducir el ritmo (error 429) o rechaza las solicitudes (error 403).

Durante una avería, la última previsión sigue visible 3 horas como máximo. Una medición de estación de más de 90 minutos deja de usarse.

Escenas

La integración añade sus tarjetas al editor de escenas, en la categoría Integraciones. El campo Vivienda lista sus viviendas.

Aviso del FMI modificado

Disparador: inicia la escena cuando un aviso cuya zona contiene una vivienda se emite, se eleva (amarillo → naranja…), se rebaja, se actualiza (mismo nivel, nuevo texto u horarios) o se levanta (cancelado o terminado). Una vivienda tiene como máximo un aviso por fenómeno: cuando el FMI emite varios, cuenta el nivel más alto. Nunca se activa en la primera lectura tras un reinicio, ni cuando el FMI no está disponible.

Filtros opcionales (vacíos: todo coincide):

• Vivienda;
• Cambio: emitido, elevado, rebajado, actualizado, levantado o terminado;
• Nivel: amarillo, naranja, rojo;
• Fenómeno: viento, lluvia, tormentas, bajas temperaturas, altas temperaturas, incendios forestales, condiciones de tráfico, seguridad de los peatones, UV, nivel del mar, otro.

Variables para las acciones siguientes: la vivienda, la zona del aviso (Uusimaa…), el cambio (issued, upgraded, downgraded, updated, lifted), el nivel (yellow, orange, red), el fenómeno (wind, rain, forest_fire…), el titular y los detalles del FMI (en inglés), y un resumen listo para enviar, por ejemplo: «Aviso naranja por viento emitido para Uusimaa, del dom., 25 oct., 08:00 al lun., 26 oct., 14:00.»

Lluvia o nieve prevista en la próxima hora

Disparador: inicia la escena cuando la previsión horaria indica precipitación en esta hora o la siguiente, donde la actualización anterior no indicaba ninguna. Se activa una vez por episodio, como máximo una vez por hora y vivienda, y nunca en la primera actualización tras un reinicio.

Filtros opcionales (vacíos: todo coincide):

• Vivienda;
• Precipitación: lluvia, aguanieve o nieve;
• Intensidad: débil, moderada o fuerte.

Variables para las acciones siguientes: el nombre de la vivienda, el tipo de precipitación (rain, sleet, snow), la intensidad (light, moderate, heavy), si hay tormenta, los minutos hasta el inicio (0 si ya está cayendo), la cantidad prevista en esa hora, su probabilidad y un resumen listo para enviar, por ejemplo: «Lluvia débil prevista dentro de 35 minutos (probabilidad del 60 %).»

Obtener la precipitación de la próxima hora

Acción: indica a la escena si llega lluvia o nieve en la próxima hora (Precipitación prevista: sí o no), cuándo, qué, con qué intensidad, y el mismo resumen. Deje Vivienda vacío para su primera vivienda con ubicación. Si ninguna previsión horaria cubre la hora, Previsión disponible es no: no lo interprete como «seco».

Obtener la previsión del día

Acción: lee la previsión de hoy (el resto del día) o de mañana para una vivienda, y devuelve:

• el cielo, como código de Gladys (clear, partly-cloudy, rain, snow…) y en palabras («Lluvia»);
• las temperaturas mínima y máxima;
• la precipitación del día y su probabilidad más alta;
• el viento más fuerte y la ráfaga más fuerte;
• un resumen, por ejemplo: «Mañana: nieve, de -3 a 1 °C, 4,2 mm de precipitación (probabilidad del 70 %).»

Obtener los avisos del FMI

Acción: lee los avisos de una vivienda, vigentes o anunciados, y devuelve si hay al menos un aviso, cuántos, el nivel más alto (none, yellow, orange, red), si un aviso está vigente ahora, el fenómeno, la zona y el titular del más alto, y un resumen, por ejemplo: «1 aviso de FMI para Casa: Aviso amarillo por viento, del dom., 25 oct., 08:00 al lun., 26 oct., 14:00.» Si el FMI no está disponible, Avisos disponibles es no.

Ejemplos de escenas

• Tormenta en camino: disparador «Aviso del FMI modificado», nivel naranja o rojo, cambio emitido o elevado, luego una notificación con el resumen y las persianas cerradas.
• Aceras resbaladizas: disparador «Aviso del FMI modificado», fenómeno seguridad de los peatones, cambio emitido, luego un recordatorio de ponerse los crampones antes de salir.
• Recoger la ropa: disparador «Lluvia o nieve prevista en la próxima hora», luego una notificación con la variable resumen.
• El tiempo de la mañana: a las 7:00, acción «Obtener la previsión del día» (hoy), luego «Obtener los avisos del FMI», luego un mensaje con ambos resúmenes.

Límites

• Desarrollada sin un Gladys funcionando en Finlandia: la integración se ha probado con respuestas reales del FMI (Helsinki, Tampere, Rovaniemi, y los avisos del 23 de octubre de 2026). Sus comentarios son bienvenidos.
• Solo Finlandia y sus alrededores (ver más arriba).
• La estación es la más cercana en un radio de 50 km que midió la temperatura en los últimos 90 minutos. Las estaciones de carretera y de puerto no lo miden todo: la previsión completa lo que les falta. Sin estación, el tiempo actual es la previsión de la hora.
• El cielo actual (despejado, lluvia…) viene de la previsión, no de la estación.
• Avisos en inglés: la integración lee los textos en inglés del FMI y traduce el nivel, el fenómeno y el cambio, no los detalles ni los nombres de las zonas.
• Solo avisos terrestres: los avisos de las zonas marítimas (viento, olas, engelamiento, tormentas en el mar) conciernen a los barcos y se descartan; el del nivel del mar, que inunda las costas, se mantiene. Los avisos verdes se descartan.
• La zona de un aviso es su polígono, tal como lo publica el FMI, más 2 km para las costas y las islas que simplifica; cerca de un límite terrestre, una vivienda puede recibir también los avisos de la región vecina.
• La hora es el paso más fino, durante unos 9 días.
• Hoy solo contiene las horas que quedan.
• Los días se cortan en la zona horaria de Gladys, para todas las viviendas.
• La integración necesita Gladys 5.2 o posterior.

Solución de problemas

• «Ninguna vivienda de Gladys tiene ubicación» — indique la ubicación de su vivienda en Configuración → Viviendas.
• «FMI no tiene una previsión utilizable para la ubicación de su vivienda» — la vivienda está fuera de la zona del FMI (lejos de Finlandia), o su ubicación es errónea: compruébela en Configuración → Viviendas.
• «FMI pide reducir el ritmo» — demasiadas solicitudes desde su conexión a Internet: la integración espera y vuelve a intentarlo por sí misma.
• «FMI rechaza las solicitudes (HTTP 403)» — actualice la integración.
• «FMI no está disponible por ahora» — Gladys no consigue acceder a opendata.fmi.fi o alerts.fmi.fi: compruebe su acceso a Internet. La integración lo vuelve a intentar a los 5 minutos, y luego cada vez con menos frecuencia.
• La prueba no menciona ninguna estación — ninguna estación del FMI a menos de 50 km midió la temperatura recientemente: el tiempo actual viene de la previsión.
• El panel sigue mostrando otro proveedor — abra los ajustes del widget del tiempo y elija FMI.
• Registros: la pestaña Registros de la integración (o docker logs en el anfitrión) muestra el inicio, cada cambio de aviso, los problemas y la vuelta del FMI, una vez cada uno. Inicie el contenedor con LOG_LEVEL=debug para ver cada actualización.

Privacidad

Las coordenadas de sus viviendas, redondeadas a unos 10 m, se envían al FMI para obtener su previsión y las estaciones cercanas, y a ningún otro lugar. El flujo de avisos es el mismo para todos: su solicitud no contiene ninguna ubicación. Sin cuenta, sin clave, nada se escribe en el disco.

Créditos

Observaciones, previsiones y avisos: Fuente: Finnish Meteorological Institute (en.ilmatieteenlaitos.fi), bajo licencia CC BY 4.0; los datos se convierten al formato meteorológico de Gladys (unidades, símbolos, días, alertas). Los símbolos meteorológicos siguen la leyenda de metno/weathericons (MET Norway). El código de previsión procede de las integraciones MET Norway y Met Éireann del mismo autor.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Sin registro	section	No	Datos abiertos del FMI (Instituto Meteorológico de Finlandia): sin cuenta ni clave API. Cada 30 minutos aproximadamente, cada vivienda ubicada en Gladys recibe las mediciones de la estación más cercana, la previsión del FMI y los avisos de su zona. Solo Finlandia y alrededores. Fuente: FMI, CC BY 4.0. No afiliada al FMI.
Unidades de los valores de escena	select	No	Unidades de las temperaturas, el viento y la precipitación que la integración pone en las variables de escena. El widget del tiempo sigue siempre la preferencia de cada usuario.
Idioma de los textos de escena	select	No	Idioma de las frases que la integración pone en las variables de escena. Automático sigue el idioma de su Gladys.

Cómo instalar FMI en Gladys

1. En Gladys, abre Integraciones: FMI 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-fmi: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-fmi.

FMI 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

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