Saltar al contenido principal

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

Integración London Air para Gladys Assistant

Calidad del aire de Londres de London Air (Imperial College): índice DAQI por distrito y sitio.

Ver en GitHubTodas las integraciones

La calidad del aire de Londres, de la London Air Quality Network (LAQN), gestionada por el Environmental Research Group del Imperial College London: el índice británico DAQI (Daily Air Quality Index) de cada distrito (borough) y de cada sitio de medición, hora a hora, con el índice de cada contaminante.

Sin afiliación con London Air ni con el Imperial College London. Los datos proceden de su API abierta (api.erg.ic.ac.uk), utilizados tal como London Air los publica.

Qué hace la integración​

  • Lee el boletín horario de London Air, sin cuenta ni clave: una solicitud cada 30 o 60 minutos cubre todos los distritos y sitios.
  • Crea un dispositivo por distrito (el peor índice de sus sitios) y un dispositivo por sitio de medición elegido, 10 en total como máximo: el DAQI (1 a 10), su banda en palabras, el índice de cada contaminante medido (PM2.5, PM10, NO₂, O₃, SO₂) y la antigüedad del boletín.
  • Añade un widget de panel Calidad del aire en Londres, dos disparadores de escena (contaminación en aumento, de nuevo baja) y una acción de escena Obtener la calidad del aire.
  • Encuentra un distrito o un sitio por su nombre o código, o los más cercanos a su casa.

Solo lectura: la integración solo lee datos públicos.

Requisitos​

  • Gladys Assistant 5.2.0 o posterior.
  • Acceso a Internet desde Gladys hacia api.erg.ic.ac.uk.
  • Para buscar alrededor de su casa: su ubicación, en Configuración → Viviendas.

Configuración​

Elegir los distritos y sitios​

  1. Abra la pestaña Configuración de la integración.
  2. Pulse Buscar una zona: escriba un distrito, un lugar o un código de sitio (Camden, Marylebone, MY1), o déjelo vacío para ver los distritos y sitios más cercanos a su casa, con su distancia.
  3. Escriba los distritos que desee en Distritos, por nombre o número, separados por comas (Camden, Westminster), y los sitios en Sitios, por código (CD1, MY1). Guarde.
  4. En la pestaña Descubrir, añádalos a Gladys.

Un distrito resume su zona; un sitio cerca de su casa o de una escuela indica lo que se respira allí (un sitio junto a una vía principal mide mucho más que un sitio de fondo). El mapa de London Air muestra todos los sitios.

Otros ajustes​

  • Lectura: cada 30 minutos (por defecto) o cada hora. London Air publica un boletín por hora: leer más a menudo no aportaría nada.
  • Idioma: idioma de los nombres de las funciones (fijados al añadir un dispositivo: elíjalo primero) y de los textos de escena. Francés por defecto.

El botón Comprobar las zonas lee el boletín en el momento e indica lo que da cada distrito y sitio, y qué nombres o códigos no se entienden.

Dispositivos​

Un dispositivo por distrito (London Air <distrito>) o por sitio (London Air \<nombre del sitio>).

FunciónValores
Índice de calidad del aire (DAQI)1 a 10, el peor contaminante
Contaminación del airela banda en palabras, en su idioma
Índice PM2.5, PM10, NO₂, O₃, SO₂1 a 10, cada contaminante
Antigüedad del boletínminutos desde la hora del boletín

Solo se crean los contaminantes que mide el sitio (o un sitio del distrito). El boletín horario da índices, no concentraciones: cada contaminante es su índice, en la misma escala de 1 a 10.

El Daily Air Quality Index británico tiene cuatro bandas: Bajo (Low, 1 a 3), Moderado (Moderate, 4 a 6), Alto (High, 7 a 9) y Muy alto (Very High, 10). El peor contaminante fija el índice. Un distrito toma, contaminante por contaminante, el peor de sus sitios.

Un contaminante «No data» conserva su último valor durante 3 horas (para que un hueco no active las escenas) y después ya no publica nada. Un boletín de más de 6 horas ya no se publica como actual: Gladys conserva los últimos valores con su fecha, y el widget indica que los datos están desactualizados.

Widget​

Calidad del aire en Londres:

  • con un distrito o sitio elegido: hasta cuatro mosaicos de contaminantes, la banda coloreada (verde Bajo, naranja Moderado, rojo Alto y Muy alto) y la antigüedad del boletín;
  • sin él: una fila por distrito o sitio, con su banda coloreada.

Escenas​

Disparador: London Air: contaminación del aire en aumento​

Se activa cuando la banda de un distrito o sitio sube a Moderado o peor, o empeora de nuevo (Moderado y luego Alto se activa dos veces). Un cambio dentro de una banda (4 y luego 5) no activa nada. Filtros: el distrito o sitio, y la nueva banda: marque las bandas a partir de su umbral (por ejemplo Alto y Muy alto). Información para las acciones: nombre, banda, índice, índice anterior, el contaminante que fija el índice, un resumen listo.

Disparador: London Air: contaminación del aire de nuevo baja​

Se activa cuando la banda vuelve a Bajo tras un episodio moderado o peor. Filtros: el distrito o sitio, y la peor banda del episodio (marque las mismas bandas que arriba para emparejar ambas escenas). Información: la nueva banda y el índice, la peor banda y el peor índice del episodio, un resumen.

El primer índice leído tras la instalación fija la banda de partida sin activar nada; un reinicio no activa dos veces el mismo cambio.

Acción: London Air: obtener la calidad del aire​

La calidad del aire de un distrito o sitio, o del peor de los añadidos: resumen, banda, índice, contaminante, el índice de cada contaminante y la antigüedad del boletín, para las acciones siguientes (un mensaje, una condición).

Ejemplos de escenas​

  • Cerrar las ventanas: disparador contaminación en aumento con las bandas Alto y Muy alto → enviar {{triggerEvent.data.summary}} y apagar la ventilación.
  • Ventilar de nuevo: disparador de nuevo baja con las mismas bandas → enviar «Puede volver a abrir las ventanas».
  • Camino a la escuela: a las 7:45, acción obtener la calidad del aire en el sitio cercano a la escuela y enviar su resumen.
  • Purificador: cuando el índice PM2.5 de su distrito llegue a 4, encender el purificador de aire.

Solución de problemas​

  • «Ningún distrito ni sitio» en la pantalla de configuración: escriba al menos un distrito o un sitio, o compruebe la ortografía con Comprobar las zonas.
  • «ningún sitio de medición en este distrito» o «no figura en el boletín de London Air»: algunos distritos no tienen ningún sitio en el boletín horario (Barnet, Bromley, la City of London… en el momento de escribir esto), y un sitio puede estar fuera de servicio. Buscar una zona muestra los que publican, con su número de sitios.
  • «No son distritos de London Air»: el nombre no está en la lista; escríbalo como lo muestra Buscar una zona, o su número.
  • Índices de contaminantes sin valor: el boletín indica a menudo «No data» para una parte de los contaminantes de un sitio (última hora aún no recibida, analizador fuera de servicio); el índice procede entonces de los demás.
  • «La API de London Air no responde»: los valores se conservan y se vuelven a leer en la siguiente lectura. La pestaña Registros indica el error una vez, y su vuelta a la normalidad.
  • Detalles en la pestaña Registros de la integración (LOG_LEVEL=debug para más).

Límites​

  • Boletín horario: índices, no concentraciones, y a menudo «No data» para una parte de los contaminantes.
  • El boletín llega con retraso: el 24 de octubre de 2026 a las 10:40, el último era el de las 8:00. La función «Antigüedad del boletín» lo muestra.
  • Son mediciones, no previsiones.
  • London Air no publica ningún límite de solicitudes: la integración hace una solicitud cada 30 o 60 minutos, sea cual sea el número de zonas, y solo mientras una de ellas esté añadida a Gladys.
  • Los disparadores siguen las bandas tal como se publican: una banda que duda entre dos valores se activa en cada cambio.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Calidad del aire en LondressectionNoLee el boletín horario de la London Air Quality Network (Environmental Research Group, Imperial College London) mediante su API abierta, sin cuenta. Sin afiliación con London Air ni con el Imperial College London.
DistritosstringNoLos distritos (boroughs) de Londres que desea seguir, por nombre o número, separados por comas: un dispositivo cada uno, con el peor índice de sus sitios. «Buscar una zona» más abajo los muestra.
SitiosstringNoLos sitios de medición que desea seguir, por su código, separados por comas: un dispositivo cada uno. Distritos y sitios juntos: 10 como máximo.
LecturaselectNoLondon Air publica un boletín cada hora.
IdiomaselectNoIdioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los textos de escena.

Cómo instalar London Air en Gladys​

  1. En Gladys, abre Integraciones: London Air 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-londonair: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-londonair.

London Air 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​

London Air 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.

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 🙂
Última actualización en