Integración domótica Hong Kong Observatory, gratuita y de código abierto

Tiempo actual, previsión a 9 días, lluvia inminente y señales de aviso para Hong Kong, del HKO.

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

Ver en GitHubTodas las integraciones

El tiempo de Hong Kong en Gladys, del Observatorio de Hong Kong (Hong Kong Observatory, HKO, 香港天文台): la temperatura de la estación meteorológica más cercana, la previsión a 9 días, la predicción inmediata de lluvia de la próxima hora y los avisos y señales vigentes (señales de ciclón tropical, avisos de lluvias torrenciales, tiempo muy caluroso…). Datos abiertos: sin cuenta ni clave API.

Fuente: Hong Kong Observatory, datos abiertos publicados en DATA.GOV.HK. Esta integración es un proyecto comunitario, no afiliado al Observatorio de Hong Kong.

Lo que obtiene

• El widget del tiempo de Gladys y el asistente usan el Observatorio: la temperatura medida por la estación más cercana a su vivienda (27 estaciones, actualizadas cada 10 minutos), la humedad medida en el Observatorio, el índice UV de la última hora, el icono del tiempo actual, la salida y la puesta del sol, y los 8 días siguientes (cielo, temperaturas mínima y máxima, humedad, viento, probabilidad de lluvia significativa). Todo se muestra en °C y m/s o en °F y mph, según el sistema de unidades de cada usuario de Gladys.
• Los avisos y señales vigentes, como alertas en el widget del tiempo: señales de ciclón tropical n.º 1 a n.º 10 y el aviso especial previo a la n.º 8, avisos de lluvias torrenciales ámbar, rojo y negro, tormentas, inundaciones en el norte de los Nuevos Territorios, deslizamientos de tierra, monzón fuerte, tiempo muy caluroso, tiempo frío, heladas, peligro de incendio y tsunami. El disparador de escena alerta meteorológica integrado en Gladys funciona con ellos y se activa unos diez minutos después de un cambio.
• Disparador de escena «Aviso de Hong Kong modificado»: una señal emitida, elevada (n.º 3 → n.º 8, ámbar → rojo), rebajada, actualizada o cancelada, con una frase en su idioma.
• Disparador de escena «Lluvia prevista en la próxima hora», según la predicción inmediata de lluvia del Observatorio.
• Acción de escena «Obtener la lluvia 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 de Hong Kong»: el número de la señal de tifón, el color del aviso de lluvias y la gravedad más alta, para condicionar una escena.

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

Solo Hong Kong. Para una vivienda en otro lugar, la integración responde «sin previsión» y Gladys usa su siguiente proveedor del tiempo.

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.
2. Instale Hong Kong Observatory desde la tienda de integraciones (o Integraciones → Instalar desde GitHub con la dirección https://github.com/guim31/gladys-hko). Gladys le pide autorizar el acceso a la ubicación de sus viviendas: la integración elige la estación y el punto de predicción inmediata más cercanos a cada vivienda, y comprueba que está en Hong Kong.
3. Abra la pestaña Configuración y haga clic en Probar el Observatorio. La respuesta muestra la temperatura de la estación más cercana a su vivienda y los avisos vigentes.

Eso es todo: el widget del tiempo de su panel muestra ahora el Observatorio. Si hay otra integración del tiempo 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 lluvia 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 («Emitido: Señal n.º 8 de temporal del noreste.»): 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 Observatorio (texto de la previsión, detalles de los avisos) están en inglés.

Frecuencia de actualización y condiciones del Observatorio

El Observatorio publica estos datos libremente en DATA.GOV.HK, sin límite de solicitudes publicado. La integración se mantiene ligera:

• un temporizador funciona cada 10 minutos, más hasta 2 minutos al azar para que no todos los Gladys llamen en el mismo segundo;
• el parte meteorológico actual y los avisos se leen cada 10 minutos, la previsión a 9 días y la previsión local cada 30 minutos (pequeñas respuestas JSON, las mismas para todas las viviendas);
• la predicción inmediata de lluvia es un archivo de 2,7 MB que cubre el delta del río de las Perlas, descargado cada 30 minutos (unos 130 MB al día);
• no se llama a nada mientras ninguna vivienda de Gladys esté en Hong Kong, y abrir el panel no cuesta nada: Gladys se sirve desde la memoria;
• hace una pausa si el Observatorio pide reducir el ritmo (error 429) o rechaza las solicitudes (error 403).

Durante una avería, el último parte y la última previsión siguen visibles 3 horas como máximo.

Escenas

La integración añade sus tarjetas al editor de escenas, en la categoría Integraciones. El campo Vivienda lista sus viviendas; solo afecta a las viviendas situadas en Hong Kong.

Aviso de Hong Kong modificado

Disparador: inicia la escena cuando un aviso o una señal del Observatorio se emite, se eleva (n.º 3 → n.º 8, ámbar → rojo…), se rebaja, se actualiza (la n.º 8 cambia de cuadrante, reemitida, prolongada) o se cancela. Se activa para cada vivienda en Hong Kong, nunca en la primera lectura tras un reinicio, ni cuando el Observatorio no está disponible.

Filtros opcionales (vacíos: todo coincide):

• Vivienda;
• Cambio: emitido, elevado, rebajado, actualizado, cancelado;
• Gravedad: menor (señal de alerta n.º 1), moderada (n.º 3, aviso previo a la n.º 8, lluvias ámbar, tormentas, mucho calor, frío, heladas, monzón fuerte, incendio amarillo), grave (n.º 8, lluvias rojo, deslizamientos, inundaciones, incendio rojo), extrema (n.º 9, n.º 10, lluvias negro, tsunami);
• Fenómeno: ciclón tropical, lluvias torrenciales, tormentas, inundaciones, deslizamientos de tierra, monzón fuerte, tiempo muy caluroso, tiempo frío, heladas, peligro de incendio, tsunami, otro.

Variables para las acciones siguientes: la vivienda, el cambio (issued, upgraded, downgraded, updated, lifted), la gravedad (minor, moderate, severe, extreme), el fenómeno (tropical_cyclone, rainstorm…), el código de la señal del Observatorio (TC8NE, WRAINR…), el nombre de la señal en su idioma, los detalles del Observatorio (en inglés) y un resumen listo para enviar, por ejemplo: «Elevado: Señal n.º 9 de temporal en aumento (antes Señal n.º 8 de temporal del noreste).»

Lluvia prevista en la próxima hora

Disparador: inicia la escena cuando la predicción inmediata de lluvia indica lluvia en la vivienda en la próxima hora, donde la lectura anterior no indicaba ninguna. Se activa una vez por episodio, como máximo una vez por hora y vivienda, y nunca en la primera lectura tras un reinicio.

Filtros opcionales (vacíos: todo coincide):

• Vivienda;
• Intensidad: débil (menos de 2,5 mm/h), moderada (hasta 7,6 mm/h) o fuerte.

Variables para las acciones siguientes: el nombre de la vivienda, la intensidad (light, moderate, heavy), los minutos hasta el inicio (0 si ya llueve), la lluvia prevista en la próxima hora y un resumen listo para enviar, por ejemplo: «Lluvia moderada prevista en 20 minutos.»

Obtener la lluvia de la próxima hora

Acción: indica a la escena si llega lluvia en la próxima hora (Lluvia prevista: sí o no), cuándo, con qué intensidad, cuánta, y el mismo resumen. Deje Vivienda vacío para su primera vivienda con ubicación. Si la predicción inmediata no cubre la hora (vivienda fuera de Hong Kong, descarga fallida), Predicción disponible es no: no lo interprete como «seco».

Obtener la previsión del día

Acción: lee la previsión de hoy o de mañana y devuelve:

• el cielo, como código de Gladys (clear, partly-cloudy, rain…) y en palabras («Lluvia»);
• las temperaturas mínima y máxima, y la humedad;
• la probabilidad de lluvia significativa tal como la da el Observatorio (low, medium_low, medium, medium_high, high) y en porcentaje (el centro de la clase: 15, 38, 50, 63 u 85);
• el viento, leído del texto de la previsión;
• el texto de la previsión del Observatorio (en inglés);
• un resumen, por ejemplo: «Mañana: cielo despejado, de 25 a 31 °C, probabilidad baja de lluvia significativa.»

La previsión a 9 días empieza mañana una vez publicada la actualización de la mañana: hoy da entonces el cielo actual y el texto de la previsión del Observatorio para el resto del día, sin temperaturas.

Obtener los avisos de Hong Kong

Acción: devuelve si hay al menos un aviso vigente, cuántos, la gravedad más alta (none, minor, moderate, severe, extreme), la señal de ciclón tropical (0, 1, 3, 8, 9 o 10), la señal de lluvias (none, amber, red, black), el fenómeno, el código y el nombre del más alto, y un resumen, por ejemplo: «1 aviso vigente en Hong Kong: Aviso rojo de peligro de incendio.» Si el Observatorio no está disponible, Avisos disponibles es no.

Ejemplos de escenas

• Tifón en camino: disparador «Aviso de Hong Kong modificado», fenómeno ciclón tropical, cambio emitido o elevado, gravedad grave o extrema, luego una notificación con el resumen, las persianas cerradas y las luces del balcón apagadas.
• Lluvia negra: disparador «Aviso de Hong Kong modificado», fenómeno lluvias torrenciales, gravedad extrema, luego un mensaje para quedarse en casa.
• Recoger la ropa: disparador «Lluvia 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 de Hong Kong», luego un mensaje con ambos resúmenes; sin riego del jardín si la señal de lluvias no es none.

Limitaciones

• Desarrollada sin un Gladys instalado en Hong Kong: la integración se ha probado con respuestas reales del Observatorio (24 de octubre de 2026, con un aviso rojo de peligro de incendio vigente) y, para las señales de tifón y de lluvias, con el formato documentado de la API. Sus comentarios son bienvenidos.
• Solo Hong Kong (ver arriba).
• Sin previsión horaria: los datos abiertos del Observatorio no la tienen, así que la franja de 24 horas del widget del tiempo queda vacía; los días vienen de la previsión a 9 días.
• La estación es la más cercana entre las 27 del parte actual (las estaciones de cumbre se descartan). La humedad es la del Observatorio, el índice UV el de King’s Park.
• El cielo actual es el icono del Observatorio para todo el territorio.
• Avisos para todo el territorio: el Observatorio no indica zona; cada vivienda en Hong Kong recibe cada aviso, incluido el de inundaciones en el norte de los Nuevos Territorios.
• Textos en inglés: la integración traduce los nombres de las señales, el cielo y el cambio, no los detalles ni el texto de la previsión.
• La predicción inmediata de lluvia tiene una malla de 2 km y pasos de media hora; leída cada 30 minutos, un chubasco que empieza entre dos descargas lo anuncia la siguiente.
• La probabilidad de lluvia es una clase; el porcentaje dado a Gladys es su centro.
• 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.
• «Ninguna vivienda de Gladys está en Hong Kong» — el Observatorio solo cubre Hong Kong: compruebe la ubicación de su vivienda en Configuración → Viviendas.
• «El Observatorio pide reducir el ritmo» — demasiadas solicitudes desde su conexión a Internet: la integración espera y lo reintenta sola.
• «El Observatorio rechaza las solicitudes (HTTP 403)» — actualice la integración.
• «El Observatorio de Hong Kong no está disponible por ahora» — Gladys no llega a data.weather.gov.hk: compruebe su acceso a Internet. La integración lo reintenta a los 5 minutos, luego cada vez con menos frecuencia.
• «Obtener la lluvia de la próxima hora» indica que la predicción no está disponible — la descarga de 2,7 MB falló o tardó demasiado (el Observatorio la sirve despacio fuera de Hong Kong): se reintenta en la siguiente actualización, 10 minutos después.
• El panel sigue mostrando otro proveedor — abra los ajustes del widget del tiempo y elija Hong Kong Observatory.
• Registros: la pestaña Registros de la integración (o docker logs en el host) muestra el inicio, cada cambio de aviso, los problemas y la vuelta del Observatorio, una vez cada uno. Inicie el contenedor con LOG_LEVEL=debug para ver cada actualización.

Privacidad

Nada sobre usted sale de Gladys: cada solicitud pide datos iguales para todos (parte, previsiones, avisos y predicción inmediata del territorio). La ubicación de sus viviendas solo se usa dentro del contenedor, para elegir la estación y el punto de predicción inmediata más cercanos. Sin cuenta, sin clave, no se escribe nada en el disco.

Créditos

Tiempo actual, previsiones, avisos y predicción inmediata de lluvia: Hong Kong Observatory (hko.gov.hk), datos abiertos publicados en DATA.GOV.HK según sus condiciones de uso; los datos se convierten al formato del tiempo de Gladys (unidades, iconos, días, alertas). El vocabulario de los iconos y las señales sigue la documentación de la API de datos abiertos del Observatorio. Inspirada en la integración hko de Home Assistant (Apache 2.0). La salida y la puesta del sol se calculan con los algoritmos de la calculadora solar de la NOAA.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Sin registro	section	No	Datos abiertos del Observatorio de Hong Kong: sin cuenta ni clave API. Cada vivienda situada en Hong Kong recibe la temperatura de la estación más cercana, la previsión a 9 días, la lluvia inminente y las señales de aviso vigentes. En otros lugares, Gladys usa su siguiente proveedor del tiempo. Fuente: Hong Kong Observatory (DATA.GOV.HK). No afiliada al Observatorio.
Unidades de los valores de escena	select	No	Unidades de las temperaturas, el viento y la lluvia 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 Hong Kong Observatory en Gladys

1. En Gladys, abre Integraciones: Hong Kong Observatory 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-hko: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-hko.

Hong Kong Observatory 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

Hong Kong Observatory 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 🙂