Integración domótica IPMA, gratuita y de código abierto
Tiempo oficial de Portugal del IPMA: previsiones, estaciones, avisos, UV y riesgo de incendio.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
El tiempo oficial de Portugal — continente, Madeira y Azores — en Gladys, del IPMA (Instituto Português do Mar e da Atmosfera), el servicio meteorológico portugués: previsiones, observaciones de las estaciones, avisos meteorológicos, índice UV y riesgo de incendio. Para la casa familiar de allí, o simplemente para vivir en Portugal.
La integración lee los datos abiertos y gratuitos del IPMA: sin cuenta, sin clave de API. Está sin relación con el IPMA.
Desarrollada sin una instancia real de Gladys y sin acceso de red al IPMA: se ha construido y probado con respuestas reales del IPMA publicadas por la biblioteca
pyipma. Sus comentarios son bienvenidos: abra una issue en GitHub si un valor le parece erróneo.
Lo que obtiene
- Un dispositivo por lugar (un municipio, entre los 423 lugares de previsión del IPMA),
llamado
IPMA <lugar>, con:- la temperatura, la humedad, la presión, el viento y la lluvia actuales de la estación meteorológica más cercana;
- el mínimo y el máximo, la probabilidad de lluvia y el tiempo de hoy y de mañana;
- el viento (fuerza y dirección) y el índice UV de hoy;
- el riesgo de incendio de hoy (solo el continente);
- el nivel de aviso (verde, amarillo, naranja, rojo) y los avisos en curso, en palabras.
- Un widget del panel: previsión a 5 días con iconos, temperatura en directo, UV, riesgo de incendio y avisos.
- Un disparador de escena «Aviso meteorológico IPMA emitido», con el nivel, el fenómeno y el periodo.
Todo es de solo lectura: nada en Gladys puede cambiar nada en el IPMA.
Requisitos
- Gladys 5.2.0 o posterior.
- Acceso a Internet de Gladys hacia
api.ipma.pt(HTTPS). - Nada más: ni cuenta, ni clave.
Configuración
Ajustes
| Ajuste | Función |
|---|---|
| Lugar | El lugar IPMA que seguir: un municipio del Portugal continental, de Madeira o de las Azores (nombres portugueses, con el distrito o la isla). |
| Otros lugares | Opcional. Otros lugares, separados por comas: Funchal, Ponta Delgada, Lagoa (Faro). Los nombres se reconocen sin acentos ni mayúsculas; añada el distrito si un nombre es ambiguo. 10 lugares como máximo. |
| Intervalo de actualización | 15 minutos, 30 minutos (por defecto) o 1 hora. |
| Idioma de los nombres y textos | Idioma de los nombres de las funciones de los nuevos dispositivos, de los textos del tiempo y de los avisos, y de las variables de escena. Francés por defecto. |
Abra después la pestaña Descubrir y añada el dispositivo de cada lugar. Los valores llegan en unos segundos.
Lugar más cercano a una casa
El botón Usar el lugar más cercano a una casa elige el lugar IPMA más cercano a una casa de Gladys y lo guarda como lugar principal. Gladys pide, en la instalación, compartir la posición de las casas con la integración: solo se lee cuando usted pulsa este botón, y nunca se escribe en los registros. Una casa a más de 60 km de cualquier lugar IPMA (una casa en Francia, por ejemplo) se rechaza: el IPMA solo cubre Portugal.
El dispositivo
| Función | Tipo en Gladys | Origen |
|---|---|---|
| Temperatura (estación) | temperatura, °C | estación IPMA más cercana (a 50 km como máximo), último registro horario de 3 h |
| Humedad (estación) | humedad, % | la misma estación |
| Presión (estación) | presión, hPa | la misma estación (no todas la miden) |
| Viento (estación) | velocidad, km/h | la misma estación |
| Lluvia última hora (estación) | precipitación, mm/h | la misma estación (no todas tienen pluviómetro) |
| Mín. / Máx. hoy, Mín. / Máx. mañana | mínimo / máximo, °C | previsión IPMA del lugar |
| Probabilidad de lluvia hoy / mañana | contador, % | previsión IPMA |
| Tiempo hoy / mañana | texto | tipo de tiempo IPMA, traducido («Lluvia débil o llovizna») |
| Viento hoy | texto | clase y dirección del viento IPMA («Moderado, NO») |
| Índice UV | índice UV | previsión IPMA, máximo del día |
| Riesgo de incendio (1-5) | contador | RCM del IPMA: 1 bajo, 2 moderado, 3 alto, 4 muy alto, 5 máximo (continente) |
| Nivel de aviso | nivel de riesgo | aviso más alto en curso: 0 ninguno (verde), 1 amarillo, 2 naranja, 3 rojo |
| Avisos meteorológicos | texto | «Naranja: Mar agitado · Amarillo: Viento», o el próximo aviso |
El nivel de aviso usa la insignia de riesgo de Gladys: verde, amarillo, naranja, rojo — los colores del IPMA. Un valor que el IPMA no da (ninguna estación cercana, ninguna previsión UV ese día) simplemente no se actualiza. Los textos del tiempo siguen el idioma de la configuración; los nombres de las funciones se fijan al añadir el dispositivo.
Widget del panel
Añada el widget Previsión IPMA a un panel y elija el lugar (vacío: el primero). Muestra:
- la estación utilizada y la hora de su último registro;
- la temperatura en directo, el índice UV, el riesgo de incendio y el nivel de aviso;
- los avisos aún no terminados (en curso o próximos), con el texto del IPMA (en portugués) al tocarlos;
- cinco días: tiempo con su icono, mínimo / máximo, probabilidad de lluvia.
Disparador de escena
Aviso meteorológico IPMA emitido se activa una vez por cada aviso que el IPMA emite para un lugar — a menudo la víspera de su inicio. Un aviso elevado de nivel (de amarillo a naranja) se vuelve a activar. Un reinicio de la integración no vuelve a activar los mismos avisos.
Filtros: el lugar (dispositivo), los niveles (amarillo, naranja, rojo), los fenómenos (lluvia, tormentas, viento, mar agitado, calor, frío, nieve, niebla, otro).
Variables para las acciones siguientes de la escena:
| Variable | Ejemplo |
|---|---|
location | Aveiro |
level | orange |
level_label | Naranja |
phenomenon | coastal |
phenomenon_label | Mar agitado |
starts_at | 2022-07-29T05:00:00.000Z |
ends_at | 2022-07-29T20:00:00.000Z |
active | false (aún no iniciado) |
description | el texto del IPMA, en portugués |
Botones de configuración
- Usar el lugar más cercano a una casa: véase más arriba.
- Comprobar el IPMA ahora: lee el IPMA para cada lugar configurado (añadido a Gladys o no) y dice lo que ha llegado: temperatura de la estación, mínimo y máximo de hoy, número de avisos, nombres de lugares desconocidos, archivos inaccesibles.
Ejemplos de escenas
- Temporal en la casa familiar: disparador «Aviso meteorológico IPMA emitido», lugar Aveiro,
niveles naranja y rojo → enviar un mensaje construido con las variables
level_label,phenomenon_labelylocation: «Aviso IPMA Naranja en Aveiro: Mar agitado». - Ola de calor: disparador «Aviso meteorológico IPMA emitido», fenómeno calor → recordar al vecino que riegue el jardín.
- Riesgo de incendio: cuando la función «Riesgo de incendio (1-5)» supere 3 → notificación «hoy no hay barbacoa».
- Probabilidad de lluvia: cada tarde a las 20:00, si «Probabilidad de lluvia mañana» supera el 70 % → cerrar el toldo.
Datos y actualización
La integración se actualiza sola (no depende del sondeo de Gladys): cada 15, 30 o 60 minutos lee cinco archivos del IPMA — las estaciones (una vez al día), las observaciones de las últimas 24 horas, los avisos, el riesgo de incendio de hoy y una previsión por lugar. Estos archivos cubren todo el país: diez lugares cuestan diez archivos de previsión más cuatro comunes por actualización. El IPMA no publica ninguna cuota para sus datos abiertos; la integración se queda muy por debajo de lo que carga su propio sitio web. No se lee nada para un lugar cuyo dispositivo no se ha añadido a Gladys.
El IPMA actualiza sus previsiones varias veces al día, sus estaciones una vez por hora y sus avisos cuando hace falta. Un valor sin cambios se reenvía a Gladys cada 6 horas, para que nunca muestre «Sin valor reciente». Los datos son © IPMA, reutilizados según sus condiciones de datos abiertos, con mención de la fuente.
Solución de problemas
- «Elija un lugar en la configuración»: no hay ningún lugar elegido — elija uno, o use el botón de la casa.
- «El IPMA no responde»: no se ha podido leer ningún archivo del IPMA. Compruebe que Gladys accede a Internet y pulse Comprobar el IPMA ahora. La integración lo vuelve a intentar en cada actualización y lo indica en sus registros cuando el IPMA vuelve a responder.
- Los valores de la estación se quedan vacíos: ninguna estación IPMA a menos de 50 km ha enviado un registro en las últimas 3 horas (frecuente en las islas pequeñas). La previsión sigue funcionando.
- Un lugar de «Otros lugares» se ignora: el nombre es desconocido — compruebe la ortografía, o
añada el distrito:
Lagoa (Faro). El botón Comprobar el IPMA ahora lista los nombres desconocidos. - Más detalles: ponga
LOG_LEVEL=debugen la integración para ver cada actualización en sus registros.
Límites
- Solo Portugal (continente, Madeira, Azores): el IPMA no cubre nada más.
- Sin riesgo de incendio en Madeira y las Azores: el IPMA solo lo prevé para el continente.
- El archivo de previsión utilizado es el del sitio web del IPMA (
public-data), como la integración de Home Assistant; el IPMA puede cambiarlo sin previo aviso. - El IPMA redacta sus avisos en portugués: el nivel y el fenómeno se traducen, el texto libre no.
- Sin relación con el IPMA. Desarrollada sin una instancia real de Gladys: sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que IPMA te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Tiempo en Portugal | section | No | Previsiones, observaciones, avisos meteorológicos, índice UV y riesgo de incendio del IPMA, el servicio meteorológico portugués: Portugal continental, Madeira y Azores. Datos abiertos gratuitos, sin cuenta. Elija un lugar y añada su dispositivo en la pestaña Descubrir. Sin relación con el IPMA. |
| Lugar | select | Sí | Lugar IPMA (municipio) que seguir. El botón «Usar el lugar más cercano a una casa» de abajo puede elegirlo por usted. |
| Otros lugares | string | No | Opcional: otros lugares IPMA, separados por comas, un dispositivo cada uno (10 lugares en total). |
| Intervalo de actualización | select | No | Frecuencia de lectura del IPMA. Sus estaciones publican una vez por hora. |
| Idioma de los nombres y textos | select | No | Nombres de las funciones de los nuevos dispositivos, textos del tiempo y de los avisos, variables de escena. |
Cómo instalar IPMA en Gladys
- En Gladys, abre Integraciones: IPMA 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-ipma: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). - 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-ipma.
IPMA 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
IPMA 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