Integración domótica Met Office, gratuita y de código abierto
Previsiones del Met Office británico: temperatura, viento, lluvia, UV, visibilidad y 7 días.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Las previsiones del Met Office, el servicio meteorológico nacional del Reino Unido, en Gladys: temperatura, sensación térmica, humedad, presión, viento, probabilidad e intensidad de precipitación, visibilidad, índice UV y el tiempo de la hora, para su casa o cualquier lugar, con los 7 próximos días en el panel. Los datos proceden del plan gratuito del Met Office Weather DataHub (la previsión «Site-specific», la que usa Home Assistant desde el cierre del antiguo servicio DataPoint).
Esta integración está sin relación con el Met Office, que no la respalda. Se ha desarrollado sin el hardware y sin cuenta de DataHub (solo hace falta la clave de API, ningún dispositivo): las respuestas de la API proceden de su documentación y de las pruebas de Home Assistant. Sus comentarios son bienvenidos.
Presentación
- Un dispositivo por lugar: las casas de Gladys (su ubicación en los ajustes), o hasta 3 lugares introducidos como coordenadas.
- Cada dispositivo lleva la previsión de la hora actual: temperatura, sensación térmica, humedad, presión, velocidad, ráfagas y dirección del viento, probabilidad de precipitación, intensidad de precipitación, visibilidad, índice UV y el estado del tiempo como texto («Lluvia ligera», «Soleado»…).
- Un widget de panel: ahora, luego los 7 próximos días (toque un día para ver el detalle) o las 24 próximas horas (la curva de temperatura y las horas siguientes).
- Una acción de escena: la previsión de hoy, mañana o pasado mañana (máxima, mínima, probabilidad de lluvia, ráfagas, UV, tiempo) para los pasos siguientes de una escena.
- Solo lectura: no se controla nada, al Met Office solo se envía la posición de los lugares.
El modelo del Met Office cubre todo el mundo («Global Spot») y es más preciso sobre el Reino Unido.
Requisitos
- Gladys 5.1 o posterior.
- Una cuenta y una clave de API gratuitas del Met Office Weather DataHub: regístrese en datahub.metoffice.gov.uk, abra el producto Site Specific, suscríbase a su plan gratuito (Global Spot) y copie la clave de API de la suscripción. Solo se muestra una vez: si la pierde, restablézcala en My subscriptions.
- Un lugar: una casa de Gladys ubicada en Ajustes → Casas, o coordenadas.
- Gladys debe acceder a Internet (
data.hub.api.metoffice.gov.uk).
Configuración
- En Integraciones, instale Met Office. La pantalla de instalación indica que lee la ubicación de sus casas: así prevé el tiempo para ellas sin volver a pedir coordenadas.
- Abra la pestaña Configuración y pegue la clave de API.
- Lugares que prever: Las casas de Gladys (por defecto) toma cada casa ubicada, 3 como máximo;
una casa sin ubicación se omite. Coordenadas usa el campo Coordenadas: latitud y longitud en
grados decimales, un nombre opcional antes de dos puntos, lugares separados por punto y coma, por
ejemplo
Exeter: 50.7184, -3.5339; Leeds: 53.7997, -1.5492. - Elija el intervalo de actualización (30 minutos por defecto) y el idioma de los textos.
- Guarde y pulse Probar la conexión: cada lugar responde con su temperatura, su tiempo y la distancia al punto del modelo, y el informe indica cuántas llamadas a la API al día consumen los ajustes.
- Abra la pestaña Descubrimiento y añada los lugares.
Los nombres de las funciones se fijan al añadir un lugar: cambie el idioma antes de añadirlo. Una casa conserva su dispositivo cuando se mueve su ubicación; unas coordenadas introducidas que cambian más de unos 100 m dan un dispositivo nuevo.
Los dispositivos de lugar
Cada lugar es un dispositivo llamado «Met Office» seguido del nombre de la casa, del nombre introducido o, en su defecto, del nombre que el Met Office da a su punto del modelo («Met Office Wavertree»). Sus funciones, en unidades métricas:
| Función | Unidad | Nota |
|---|---|---|
| Temperatura | °C | a 1,5 m |
| Sensación térmica | °C | con el viento y la humedad |
| Humedad | % | humedad relativa |
| Presión atmosférica | hPa | reducida al nivel del mar |
| Velocidad del viento, ráfagas | km/h | a 10 m |
| Dirección del viento | ° | de dónde viene el viento: 0 = norte, 90 = este |
| Probabilidad de precipitación | % | de la hora |
| Intensidad de precipitación | mm/h | |
| Visibilidad | km | |
| Índice UV | ||
| Estado del tiempo | texto | «Lluvia ligera», «Parcialmente nuboso»… en el idioma configurado |
Son previsiones para la hora actual, no mediciones: el modelo del Met Office da un valor para cada hora, y el dispositivo sigue la hora más cercana al reloj. Solo se envían a Gladys los valores que cambian, y cada valor se reenvía al menos cada 6 horas para que nunca parezca caducado.
Si el Met Office no puede consultarse durante 6 horas, el dispositivo deja de actualizarse (una previsión antigua parecería actual) y su distintivo en la lista de dispositivos pasa a naranja, o a rojo mientras el servicio no responda. Todo vuelve con la siguiente lectura correcta.
Widget de panel
Añada el widget Previsión Met Office a un panel, elija un lugar (vacío: el primero) y una vista:
- Próximos 7 días (por defecto): la temperatura, la probabilidad de lluvia y el viento de ahora, luego una línea por día con su tiempo, su máxima y la mínima de la noche siguiente, y su probabilidad de lluvia. Toque un día: tiempo del día y de la noche, viento, ráfagas, índice UV.
- Próximas 24 horas: la curva de temperatura con su máxima y su mínima, luego las 6 próximas horas.
La hora del cálculo del modelo aparece bajo el nombre. El widget sigue las unidades de su perfil de Gladys (°F y mph en unidades imperiales) y nunca llama a la API: muestra las últimas previsiones leídas.
Disparadores y acciones de escena
Met Office: previsión de un día (acción de escena) — elija un lugar (vacío: el primero) y un día (hoy, mañana por defecto, pasado mañana). Los pasos siguientes de la escena pueden usar: el lugar, la fecha, el tiempo del día (texto) y su código del Met Office, la temperatura máxima, la mínima de la noche siguiente, la probabilidad de lluvia del día y de la noche (%), las ráfagas a mediodía (km/h) y el índice UV máximo. Los textos están en el idioma de la configuración. La acción lee la previsión ya obtenida (actualizada cada 3 horas) y no cuesta ninguna llamada a la API.
No hay disparador de escena: el tiempo de ahora es una función del dispositivo de lugar, que la tarjeta estándar Cambia el estado de un dispositivo ya gestiona (por ejemplo «probabilidad de precipitación por encima de 80»).
Ejemplos de escenas
- Riego del jardín: cada tarde a las 20 h, ejecute Met Office: previsión de un día para mañana y riegue solo si la probabilidad de lluvia del día es inferior al 40 %.
- Alerta de helada: cada tarde, obtenga la previsión de mañana y envíe «Helada esta noche, cubra las plantas» cuando la temperatura mínima sea inferior a 1 °C.
- Toldo: cuando las Ráfagas de viento del lugar superen 40 km/h, recoja el toldo.
- Tendedero: cada mañana, envíe «Buen día para tender la ropa» cuando la probabilidad de lluvia del día sea inferior al 20 %.
- Resumen matinal: a las 7 h, envíe «Hoy: {tiempo}, {máx} °C, {lluvia} % de probabilidad de lluvia» con los resultados de la acción.
Cuota de la API y actualización
El plan gratuito de la previsión Site-specific permite 360 llamadas a la API al día, para todas las herramientas que usan la clave (una llamada no usada no se traslada al día siguiente). Cada lugar cuesta una llamada por actualización de la previsión horaria y una llamada cada 3 horas para la previsión de 7 días: 56 llamadas al día para un lugar cada 30 minutos, 104 cada 15 minutos. Caben 3 lugares como máximo en la cuota con cualquier intervalo; la integración reserva un 10 % para reinicios y pruebas, y se ralentiza sola si hace falta. Solo se actualizan los lugares añadidos a Gladys. Si la clave se usa en otro sitio (otro sistema domótico, un script), elija un intervalo más lento.
Si aun así la cuota se agota (HTTP 429), las lecturas se detienen una hora. Una clave rechazada se vuelve a probar cada hora, o en cuanto se guarda la configuración. El modelo del Met Office se calcula cada hora: actualizar más rápido que cada 15 minutos no aportaría nada nuevo.
Solución de problemas
- «El Met Office rechaza la clave de API»: vuelva a copiar la clave desde el DataHub, en My subscriptions (restablézcala si la ha perdido), y compruebe que la suscripción es la de Site Specific.
- «Ningún lugar que prever»: ubique una casa en Ajustes → Casas de Gladys, o elija Coordenadas y rellene el campo.
- «Ignoradas, no son coordenadas» en el informe de prueba: no se ha podido leer una entrada del
campo; escriba
latitud, longituden grados decimales (51.5072, -0.1276). - «Cuota diaria de la API agotada»: vea «Cuota de la API y actualización»; las lecturas se reanudan al cabo de una hora.
- «El Met Office Weather DataHub no responde»: Gladys no llega a
data.hub.api.metoffice.gov.uk: compruebe su conexión a Internet y su DNS. - El punto del modelo está lejos (informe de prueba): la previsión corresponde al punto más cercano de la malla del Met Office, normalmente a pocos kilómetros.
- Detalles: ponga
LOG_LEVEL=debugen el contenedor para ver cada lectura en los registros de la integración. La clave de API nunca se escribe en ellos.
Límites
- Previsiones, no observaciones: los valores de «ahora» son la previsión del modelo para la hora actual.
- Viento en km/h en los dispositivos (los sensores de velocidad de Gladys conocen km/h y m/s, no mph); el widget muestra mph a los perfiles en unidades imperiales.
- 3 lugares como máximo, el límite de la cuota gratuita. Un plan de pago no se tiene en cuenta.
- El texto del estado del tiempo está en el idioma de la configuración, no en el de cada usuario.
- El día de una previsión diaria es la fecha del Met Office (hora del Reino Unido): para un lugar lejos del Reino Unido, el «hoy» del widget puede empezar unas horas antes o después.
- Sin avisos meteorológicos: los avisos del Met Office no forman parte de esta API.
- Los datos y su disponibilidad dependen del Met Office, que puede cambiar sus planes en cualquier momento.
- Desarrollada sin el hardware ni cuenta: las respuestas proceden de la documentación de la API y de las pruebas de Home Assistant, aún no de una clave real. Los comentarios son bienvenidos en el repositorio de GitHub.
Parámetros de configuración
Estos son los parámetros que Met Office te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su clave de API gratuita | section | No | Cree una cuenta gratuita en el Met Office Weather DataHub, suscríbase al plan gratuito de Site Specific Global Spot y copie la clave de API que se muestra una sola vez. El plan gratuito permite 360 llamadas al día. |
| Clave de API | secret | Sí | La clave de la suscripción Site Specific (un texto largo, no su contraseña). |
| Lugares que prever | select | No | Las casas ubicadas en los ajustes de Gladys, o las coordenadas de abajo. 3 lugares como máximo. |
| Coordenadas | string | No | Solo con Coordenadas. Latitud, longitud, un nombre opcional antes de dos puntos; lugares separados por punto y coma. |
| Intervalo de actualización | select | No | Con qué frecuencia se lee la previsión horaria de cada lugar; la de 7 días cada 3 horas. Cabe en 360 llamadas al día. |
| Idioma de los textos | select | No | Nombres de las funciones al añadir un lugar, y el estado del tiempo (Lluvia ligera…). |
Cómo instalar Met Office en Gladys
- En Gladys, abre Integraciones: Met Office 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-met-office: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-met-office.
Met Office 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
Met Office 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