Saltar al contenido principal

Integración domótica FAA Airport Status, gratuita y de código abierto

Integración FAA Airport Status para Gladys Assistant

Retrasos en aeropuertos de EE. UU. (FAA): paradas en tierra, programas de retraso, salidas, llegadas

Ver en GitHubTodas las integraciones

El estado de los aeropuertos de Estados Unidos en Gladys, tal como lo publica la Federal Aviation Administration (FAA): paradas en tierra, programas de retrasos en tierra, retrasos de salidas y llegadas, y cierres. Útil antes de un viaje hacia o desde Estados Unidos, o para seguir el aeropuerto del vuelo de un familiar.

Los datos proceden de FAA NAS Status, el flujo abierto de la FAA sobre el espacio aéreo estadounidense: sin cuenta ni clave. Esta integración no está afiliada a la FAA.

Desarrollada fuera de Estados Unidos: sus comentarios son bienvenidos. Está construida y probada con respuestas reales de la FAA (un día de tormentas en verano, una tormenta de nieve, una mañana tranquila) y su contenedor se ejecutó con el flujo real; todavía no se ha usado en muchas instalaciones de Gladys.

Lo que obtiene​

  • Un dispositivo por aeropuerto seguido (JFK, ATL, SFO… o cualquier código FAA): su estado en palabras, un nivel de incidencia de 0 a 3, cuatro sí/no (retrasos, parada en tierra, programa de retrasos en tierra, cierre), los retrasos medio y máximo de salidas y llegadas en minutos, y la causa (tormentas, viento, nubes bajas, tráfico intenso…).
  • Un widget del panel: el estado de cada aeropuerto seguido, el más afectado primero.
  • Un disparador de escena: la FAA declara o levanta retrasos, una parada en tierra o un cierre.
  • Una acción de escena: leer el estado de un aeropuerto, con una frase lista para enviar por mensaje o a un altavoz.

Requisitos​

  • Gladys Assistant 5.1.0 o posterior.
  • Acceso a Internet desde el equipo de Gladys (la integración llama a nasstatus.faa.gov).

Instalación​

  1. En Gladys, abra Integraciones → Instalar desde GitHub.
  2. Pegue https://github.com/guim31/gladys-faa e instale.
  3. Abra la pestaña Configuración de la integración para seguir aeropuertos (abajo).

Configuración​

Ajustes​

  • Idioma de los textos: el idioma de los nombres de funciones (fijados al crear un dispositivo), de los estados, de las causas y de las frases enviadas a sus escenas.
  • Intervalo de actualización: 5 minutos (por defecto) o 10 minutos. Una sola petición sirve a todos los aeropuertos seguidos.

Seguir un aeropuerto​

Use Seguir un aeropuerto con:

  • su código FAA de tres letras: JFK, LGA, EWR, ATL, ORD, SFO… (en la mayoría de los aeropuertos, el código impreso en su tarjeta de embarque);
  • o su código OACI de cuatro letras, en los Estados Unidos continentales: KJFK;
  • o el nombre de su ciudad: Atlanta, San Francisco. Cuando coinciden varios aeropuertos (Chicago, Washington, New York), la respuesta los muestra: siga el suyo por su código.

Los 77 grandes aeropuertos que sigue la FAA se conocen por su nombre. Cualquier otro código se acepta tal cual: la FAA también publica eventos de aeropuertos más pequeños (sobre todo cierres) y programas de retrasos de algunos aeropuertos canadienses (YYZ, YUL).

Luego abra la pestaña Descubrir y cree el dispositivo. Hasta 20 aeropuertos.

Eliminar, comprobar el estado​

  • Dejar de seguir un aeropuerto: escriba su código. Su dispositivo permanece en Gladys hasta que lo borre.
  • Estado: muestra los aeropuertos seguidos, su estado actual, si su dispositivo está creado y la última lectura de la FAA.

Dispositivos​

Cada dispositivo de aeropuerto tiene estas funciones (nombres en el idioma elegido al crearlo):

FunciónTipoValor
Estadotexto«Parada en tierra hasta 23:45 · Salidas 121–135 min ↗»
Nivel de incidencianivel 0 a 30 normal, 1 retrasos, 2 programa de retrasos, 3 parada/cierre
Retrasossí/nouna parada en tierra, un programa, retrasos de salidas o llegadas
Parada en tierrasí/nolos vuelos hacia este aeropuerto esperan en su origen
Programa de retrasos en tierrasí/nolas salidas hacia este aeropuerto se regulan con retrasos
Cierresí/nocerrado por un NOTAM, ahora
Retraso de salidas (medio)minutos0 si no hay
Retraso de salidas (máximo)minutos0 si no hay
Retraso de llegadas (medio)minutosel mayor entre el retraso de llegadas y el del programa
Retraso de llegadas (máximo)minutosigual
Causatexto«Tormentas», «Cierre (NOTAM)», «Ninguna incidencia»

Las horas están en la zona horaria de su Gladys. Las flechas indican si la FAA espera que los retrasos aumenten (↗) o disminuyan (↘).

Widget del panel​

Estado aeropuertos EE. UU.: una fila por aeropuerto seguido (con un dispositivo creado), el más afectado primero: verde para operaciones normales, naranja para retrasos de salidas o llegadas, rojo para un programa de retrasos en tierra, una parada en tierra o un cierre. La leyenda indica las causas. El widget muestra 10 aeropuertos como máximo: los más afectados.

Disparador de escena​

Estado de un aeropuerto cambiado: se activa cuando la FAA, en un aeropuerto seguido (o en el que usted elija):

  • declara o levanta un cierre (closed, reopened);
  • declara o levanta una parada en tierra (ground_stop_declared, ground_stop_lifted);
  • declara retrasos (salidas, llegadas o un programa de retrasos en tierra) o les pone fin (delay_declared, delay_lifted).

Elija los eventos que desee en el disparador. Las variables dan el aeropuerto, el evento, el estado en palabras, el nivel y el nivel anterior, la causa, los retrasos medios de salidas y llegadas y el fin previsto. Nada se activa en la primera lectura tras el arranque de la integración: lo que ya estaba no es noticia. El fin de los retrasos solo se anuncia tras dos lecturas seguidas sin retrasos (los retrasos de salidas van y vienen en torno al umbral de 15 minutos de la FAA).

Acción de escena​

Obtener el estado de un aeropuerto: para un aeropuerto seguido, da una frase («EWR · Newark: Parada en tierra hasta 23:45 · Salidas 121–135 min ↗. Causa: Tormentas.»), el estado, el nivel y su nombre, retrasos, parada en tierra, programa de retrasos y cierre como 1 o 0, los cuatro retrasos en minutos y la causa. Úselos en un mensaje o en un paso «Continuar solo si».

Ejemplos de escenas​

  • Antes de un vuelo: cada mañana a las 6:00, obtener el estado de JFK; continuar solo si el nivel es mayor que 0; enviar la frase por Telegram.
  • Recoger a alguien: cuando se declara una parada en tierra en el aeropuerto de llegada de la noche, enviar un mensaje «Su vuelo llegará con retraso: parada en tierra en JFK, causa: tormentas».
  • Vuelta a la normalidad: cuando terminan los retrasos en ORD, anunciarlo en el altavoz de la cocina.

Datos, actualización y condiciones​

La integración lee https://nasstatus.faa.gov/api/airport-events cada 5 o 10 minutos, una vez para todos los aeropuertos seguidos y solo cuando hay al menos un dispositivo de aeropuerto creado. Es el flujo de la propia página NAS Status de la FAA; no necesita clave y la FAA no publica ninguna cuota. Los aeropuertos ausentes de la respuesta funcionan con normalidad.

  • Parada en tierra (ground stop): la FAA retiene en su origen los vuelos con destino al aeropuerto, casi siempre por tormentas o mala visibilidad. El estado indica su fin previsto.
  • Programa de retrasos en tierra (ground delay program): la FAA regula los vuelos con destino al aeropuerto y les asigna un retraso antes del despegue; sus retrasos medio y máximo cuentan como retrasos de llegadas. Un programa anunciado para más tarde cuenta desde su inicio.
  • Retrasos de salidas y llegadas: comunicados por el aeropuerto, como un intervalo («16–30 min») con una tendencia.
  • Cierre: un NOTAM que cierra el aeropuerto ahora. Los cierres con horario diario («DLY 0430-0945») solo cuentan en ese horario; los que dejan pasar los vuelos regulares, y las restricciones solo para la aviación general, se ignoran.

Solución de problemas​

  • El dispositivo no muestra ningún valor: créelo en la pestaña Descubrir; los valores llegan en unos segundos.
  • El estado de conexión dice «La FAA no responde»: el flujo está caído o no se puede alcanzar desde su Gladys. Los últimos valores se mantienen; la integración lo vuelve a intentar en cada intervalo e indica cuándo vuelve.
  • Un aeropuerto nunca tiene incidencias: compruebe su código con Estado. Un aeropuerto que no está entre los 77 grandes rara vez aparece en el flujo.
  • Más detalles: defina LOG_LEVEL=debug en el entorno de la integración; una lectura normal no escribe nada en el nivel info.

Limitaciones​

  • La FAA cubre Estados Unidos (y algunos programas canadienses): ningún otro país.
  • Sin datos por vuelo: los retrasos son los del aeropuerto, no los de su vuelo.
  • No se muestran las restricciones para la aviación general, el deshielo ni las configuraciones de pistas.
  • Los nombres de funciones se fijan al crear el dispositivo.
  • Los cierres de la puesta a la salida del sol («SS-SR») cuentan durante todo su periodo.
  • Hasta 20 aeropuertos.

Créditos​

  • Datos: FAA NAS Status, un servicio público de la Federal Aviation Administration. Esta integración no está afiliada a la FAA ni respaldada por ella.
  • Inspirada en la integración de Home Assistant FAA Delays (Apache 2.0) y en su biblioteca faadelays.

Parámetros de configuración​

Estos son los parámetros que FAA Airport Status te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Cómo funcionasectionNoSiga aeropuertos con la acción de abajo y luego cree sus dispositivos en la pestaña Descubrir. Todo procede del flujo abierto NAS Status de la FAA: sin cuenta ni clave.
Idioma de los textosselectNoIdioma de los nombres de funciones, de los estados y de las frases enviadas a sus escenas. Los nombres se fijan al crear el dispositivo.
Intervalo de actualizaciónselectNoFrecuencia de lectura de la FAA: una sola petición para todos los aeropuertos seguidos.

Cómo instalar FAA Airport Status en Gladys​

  1. En Gladys, abre Integraciones: FAA Airport Status 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-faa: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-faa.

FAA Airport Status 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​

FAA Airport Status 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