Integración domótica AEMET, gratuita y de código abierto
El tiempo oficial de AEMET: previsiones, estación cercana y avisos Meteoalerta por municipio.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.2.0
- ★ 0
El tiempo oficial de España en Gladys, desde AEMET OpenData, el servicio de datos abiertos de la Agencia Estatal de Meteorología: la previsión de la hora en curso, los extremos del día, los avisos Meteoalerta (amarillo, naranja, rojo) y la observación de la estación meteorológica más cercana, para la península, Baleares, Canarias, Ceuta y Melilla. Pensada para segundas residencias y trabajadores transfronterizos.
Esta integración no está afiliada a AEMET. Se ha desarrollado sin una cuenta de AEMET a mano, con respuestas reales publicadas de la API: sus comentarios son bienvenidos.
Presentación
- Un dispositivo por municipio (cinco como máximo), de solo lectura.
- Previsión de la hora en curso: temperatura, sensación térmica, humedad, viento, rachas, dirección del viento, probabilidad de lluvia, lluvia prevista en la hora, cielo (traducido).
- Hoy: índice UV (máximo del día), temperaturas mínima y máxima.
- Avisos: nivel en vigor, nivel más alto previsto y un texto que los enumera.
- Estación: temperatura, humedad, presión, lluvia de la última hora y viento medidos en la estación de AEMET más cercana (40 km como máximo).
- Un widget del panel y un disparador de escena «Nuevo aviso de AEMET».
Requisitos
- Gladys 5.2.0 o posterior (la acción «Buscar el municipio más cercano» elige una casa de Gladys).
- Una clave de API de AEMET OpenData, gratuita.
- Acceso a Internet desde Gladys: la integración solo se comunica con
opendata.aemet.es.
Configuración
Clave de API
Abra la solicitud de clave de AEMET OpenData,
introduzca su dirección de correo y resuelva el captcha. AEMET envía un enlace de confirmación y, poco después,
la clave por correo: un texto largo que empieza por eyJ. Péguela en el campo Clave de API.
Municipios
El campo Municipios admite los códigos INE de cinco cifras de los municipios, separados por comas
(28079 para Madrid, 07040 para Palma). El código aparece en la dirección de la página del municipio en
aemet.es (…/madrid-id28079): puede pegar esa dirección tal cual. Cinco municipios como máximo.
Para evitar la búsqueda, la acción Buscar el municipio más cercano toma una casa de Gladys (su posición se define en los parámetros de Gladys) y añade al campo el municipio español más cercano. Recargue la página para verlo y añada después el dispositivo desde la pestaña Descubrimiento.
La acción Probar la conexión comprueba la clave e indica cada municipio y su estación.
Idioma
El campo Idioma define el idioma de los nombres de las funciones (fijados al añadir el dispositivo: elimine y vuelva a añadir el dispositivo para cambiarlos), del estado del cielo, de los avisos y de los textos de escena. Francés por defecto. El widget sigue el idioma de cada usuario.
El dispositivo del municipio
Cada municipio da un dispositivo AEMET <municipio>, con estas funciones.
Previsión
| Función | Unidad |
|---|---|
| Temperatura (previsión), sensación térmica | °C |
| Humedad (previsión) | % |
| Viento, rachas (previsión) | km/h |
| Dirección del viento (de dónde viene, 0 = norte; nada con calma) | ° |
| Probabilidad de lluvia (la franja de 6 horas de la hora en curso) | % |
| Lluvia de esta hora (previsión) | mm |
| Cielo (texto, p. ej. «Cubierto con nieve») | |
| Índice UV (máximo del día), mínima del día, máxima del día | índice, °C |
La previsión es la que AEMET publica para el municipio, hora a hora: los valores cambian cada hora, incluso entre dos consultas.
Avisos
| Función | Valores |
|---|---|
| Nivel de aviso actual | 0 ninguno, 1 amarillo, 2 naranja, 3 rojo: los avisos en vigor |
| Aviso más alto previsto | misma escala, avisos en vigor y anunciados |
| Avisos | texto, p. ej. «Rojo: Nevadas; Naranja: Temperaturas mínimas (desde lun, 00:00)» |
Un municipio recibe los avisos de su zona Meteoalerta (la zona_comarcal que AEMET da al municipio).
Observación de la estación
Temperatura, humedad, presión (a nivel del mar cuando la estación la calcula), lluvia de la última hora y viento medio de la estación más cercana, a menos de 40 km. Una observación de más de tres horas no se publica.
Actualización y cuota
AEMET limita las peticiones de cada clave, y cada consulta cuesta dos peticiones (AEMET responde con la dirección de los datos, que se descargan después). La integración consulta, para cada municipio añadido a Gladys:
- las previsiones cada 30 minutos;
- la estación cada 30 minutos (una observación por hora en AEMET);
- los avisos cada 10 minutos, una vez por región para todos sus municipios.
Son unas 24 peticiones por hora y municipio. Tras un fallo, el siguiente intento espera 5 minutos, 15 tras un rechazo por cuota. Solo se envían a Gladys los valores que cambian, y cada valor al menos cada 6 horas. La integración se actualiza sola: no depende de las consultas de Gladys.
Widget del panel
Previsión de AEMET: elija el municipio en los ajustes. Muestra en directo la temperatura, la probabilidad de lluvia, el viento y el UV, los próximos cinco días (cielo, mín. / máx., probabilidad de lluvia) y los avisos, en el idioma del usuario. Sin botones.
Disparador de escena: nuevo aviso de AEMET
Se dispara una vez por aviso, en cuanto AEMET lo publica, incluso con días de antelación, y de nuevo cuando AEMET sube su nivel. Los avisos ya en vigor al arrancar la integración, o al añadir un municipio, no se anuncian.
Filtros (todos opcionales): municipio, nivel (amarillo, naranja, rojo), fenómeno (lluvias, nevadas, vientos, tormentas, temperaturas máximas y mínimas, fenómenos costeros, nieblas, polvo en suspensión, aludes, rissagas, deshielos, otro).
Información transmitida a la escena: municipio, nivel (yellow, orange, red), resumen (nivel, fenómeno y
periodo en el idioma configurado), titular de AEMET (en español), inicio y fin (ISO), ya en vigor.
Ejemplos de escenas
- Avisarme de un aviso naranja o rojo en la segunda residencia: disparador «Nuevo aviso de AEMET», municipio = la casa, nivel = naranja, rojo; acción «Enviar un mensaje» con el resumen.
- Cerrar las persianas antes de un temporal: disparador «Nuevo aviso de AEMET», fenómeno = vientos, nivel = naranja, rojo; después cerrar las persianas.
- Alerta de heladas: disparador sobre la función «Mínima del día» por debajo de 0 °C, enviar un mensaje por la tarde.
Solución de problemas
- «AEMET ha rechazado la clave de API»: compruebe la clave (una sola línea, sin espacios); solicite una nueva si hace falta.
- «AEMET limita las peticiones de esta clave»: la clave se comparte con otra herramienta, o hay demasiados municipios: las consultas se reanudarán solas.
- Ningún dispositivo en Descubrimiento: ejecute Probar la conexión; allí se indica un código erróneo.
- Sin valores de la estación: no hay ninguna estación de AEMET a menos de 40 km, o sus observaciones llegan con retraso.
- Registros: la integración solo escribe los errores y su ciclo de vida; defina
LOG_LEVEL=debugpara ver cada consulta. La clave nunca se registra.
Limitaciones
- Solo España (la cobertura de AEMET).
- Los avisos costeros afectan a zonas litorales, distintas de la zona terrestre de un municipio: puede que no lleguen a un municipio costero.
- La estación más cercana se elige automáticamente y puede no representar bien un municipio de montaña.
- Los nombres de las funciones se fijan al añadir el dispositivo.
- Desarrollada sin cuenta de AEMET: los ficheros de avisos se construyeron según el formato CAP que documenta AEMET. Sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que AEMET te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Clave de API de AEMET OpenData | section | No | La clave de AEMET es gratuita: introduzca su dirección de correo en la página de AEMET OpenData indicada abajo, abra el enlace recibido y la clave llegará por correo poco después. La integración consulta AEMET cada 30 minutos (avisos: cada 10 minutos) para respetar la cuota de la clave. Sin relación con AEMET. |
| Clave de API | secret | Sí | |
| Municipios (códigos INE) | string | No | Códigos INE de cinco cifras, separados por comas: un dispositivo por municipio, cinco como máximo. La acción «Buscar el municipio más cercano» lo rellena a partir de una casa de Gladys. |
| Idioma de los textos de los dispositivos | select | No | Nombres de las funciones (fijados al añadir el dispositivo), estado del cielo, avisos y textos de escenas. |
Cómo instalar AEMET en Gladys
- En Gladys, abre Integraciones: AEMET 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-aemet: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-aemet.
AEMET 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
AEMET 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