Aller au contenu principal

Intégration domotique FAA Airport Status, gratuite et open source

Intégration FAA Airport Status pour Gladys Assistant

Aéroports américains (FAA) : arrêts au sol, régulations, retards au départ, à l'arrivée, fermetures

Voir sur GitHubToutes les intégrations

L'état des aéroports américains dans Gladys, tel que la Federal Aviation Administration (FAA) le publie : arrêts au sol, programmes de retards au sol, retards au départ et à l'arrivée, fermetures. Pratique avant un voyage vers ou depuis les États-Unis, ou pour suivre l'aéroport du vol d'un proche.

Les données viennent de FAA NAS Status, le flux ouvert de la FAA sur l'espace aérien américain : pas de compte, pas de clé. Cette intégration n'est pas affiliée à la FAA.

Développée hors des États-Unis : vos retours sont les bienvenus. Elle est construite et testée sur de vraies réponses de la FAA (une journée d'orages en été, une tempête de neige, un matin calme) et son conteneur a tourné sur le flux réel ; elle n'a pas encore tourné dans beaucoup d'installations Gladys.

Ce que vous obtenez​

  • Un appareil par aéroport suivi (JFK, ATL, SFO… ou n'importe quel code FAA) : son état en clair, un niveau de perturbation de 0 à 3, quatre oui/non (retards, arrêt au sol, programme de retards au sol, fermeture), les retards moyen et maximal au départ et à l'arrivée en minutes, et le motif (orages, vent, plafond bas, trafic chargé…).
  • Un widget de tableau de bord : l'état de chaque aéroport suivi, le plus perturbé en premier.
  • Un déclencheur de scène : la FAA déclare ou lève des retards, un arrêt au sol ou une fermeture.
  • Une action de scène : lire l'état d'un aéroport, avec une phrase prête à envoyer par message ou sur une enceinte.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Un accès à Internet depuis la machine de Gladys (l'intégration appelle nasstatus.faa.gov).

Installation​

  1. Dans Gladys, ouvrez Intégrations → Installer depuis GitHub.
  2. Collez https://github.com/guim31/gladys-faa et installez.
  3. Ouvrez l'onglet Configuration de l'intégration pour suivre des aéroports (ci-dessous).

Configuration​

Réglages​

  • Langue des textes : la langue des noms de fonctionnalités (fixés à la création d'un appareil), des états, des motifs et des phrases envoyées à vos scènes.
  • Fréquence de mise à jour : 5 minutes (par défaut) ou 10 minutes. Une seule requête sert tous les aéroports suivis.

Suivre un aéroport​

Utilisez Suivre un aéroport avec :

  • son code FAA à trois lettres : JFK, LGA, EWR, ATL, ORD, SFO… (pour la plupart des aéroports, le code imprimé sur votre carte d'embarquement) ;
  • ou son code OACI à quatre lettres, pour les États-Unis continentaux : KJFK ;
  • ou le nom de sa ville : Atlanta, San Francisco. Quand plusieurs aéroports correspondent (Chicago, Washington, New York), la réponse les liste : suivez le vôtre par son code.

Les 77 grands aéroports suivis par la FAA sont connus par leur nom. Tout autre code est accepté tel quel : la FAA publie aussi des événements pour de plus petits aéroports (surtout des fermetures), et des programmes de retards pour quelques aéroports canadiens (YYZ, YUL).

Ouvrez ensuite l'onglet Découverte et créez l'appareil. Jusqu'à 20 aéroports.

Retirer, vérifier l'état​

  • Ne plus suivre un aéroport : tapez son code. Son appareil reste dans Gladys jusqu'à ce que vous le supprimiez.
  • État : liste les aéroports suivis, leur état actuel, si leur appareil est créé, et la dernière lecture de la FAA.

Appareils​

Chaque appareil d'aéroport a ces fonctionnalités (noms dans la langue choisie à sa création) :

FonctionnalitéTypeValeur
Étattexte« Arrêt au sol jusqu'à 23:45 · Départs 121–135 min ↗ »
Niveau de perturbationniveau 0 à 30 normal, 1 retards, 2 programme de retards, 3 arrêt ou fermeture
Retardsoui/nonun arrêt au sol, un programme, des retards au départ ou à l'arrivée
Arrêt au soloui/nonles vols vers cet aéroport sont retenus à leur départ
Programme de retards au soloui/nonles départs vers cet aéroport sont régulés, avec des retards fixés
Fermetureoui/nonfermé par un NOTAM, en ce moment
Retard au départ (moyen)minutes0 quand il n'y en a pas
Retard au départ (maximal)minutes0 quand il n'y en a pas
Retard à l'arrivée (moyen)minutesle plus grand du retard à l'arrivée et du programme
Retard à l'arrivée (maximal)minutesidem
Motiftexte« Orages », « Fermeture (NOTAM) », « Aucune perturbation »

Les heures sont dans le fuseau horaire de votre Gladys. Les flèches disent si la FAA s'attend à ce que les retards augmentent (↗) ou diminuent (↘).

Widget de tableau de bord​

État des aéroports US : une ligne par aéroport suivi (avec un appareil créé), le plus perturbé en premier : vert pour un trafic normal, orange pour des retards au départ ou à l'arrivée, rouge pour un programme de retards au sol, un arrêt au sol ou une fermeture. La légende donne les motifs. Le widget montre 10 aéroports au plus : les plus perturbés.

Déclencheur de scène​

État d'un aéroport modifié : se déclenche quand la FAA, dans un aéroport suivi (ou celui que vous choisissez) :

  • déclare ou lève une fermeture (closed, reopened) ;
  • déclare ou lève un arrêt au sol (ground_stop_declared, ground_stop_lifted) ;
  • déclare des retards (au départ, à l'arrivée ou un programme de retards au sol) ou y met fin (delay_declared, delay_lifted).

Choisissez les événements voulus dans le déclencheur. Les variables donnent l'aéroport, l'événement, l'état en clair, le niveau et le niveau précédent, le motif, les retards moyens au départ et à l'arrivée et la fin prévue. Rien ne se déclenche à la première lecture après le démarrage de l'intégration : ce qui était déjà là n'est pas une nouvelle. La fin des retards n'est annoncée qu'après deux lectures de suite sans retard (les retards au départ vont et viennent autour du seuil de 15 minutes de la FAA).

Action de scène​

Lire l'état d'un aéroport : pour un aéroport suivi, donne une phrase (« EWR · Newark : Arrêt au sol jusqu'à 23:45 · Départs 121–135 min ↗. Motif : Orages. »), l'état, le niveau et son nom, retards, arrêt au sol, programme de retards et fermeture en 1 ou 0, les quatre retards en minutes, et le motif. Utilisez-les dans un message, ou dans une étape « Continuer seulement si ».

Exemples de scènes​

  • Avant un vol : chaque matin à 6:00, lire l'état de JFK ; continuer seulement si le niveau est supérieur à 0 ; envoyer la phrase sur Telegram.
  • Aller chercher quelqu'un : quand un arrêt au sol est déclaré à l'aéroport d'arrivée du soir, envoyer un message « Son vol aura du retard : arrêt au sol à JFK, motif : orages ».
  • Retour à la normale : quand les retards cessent à ORD, l'annoncer sur l'enceinte de la cuisine.

Données, mise à jour et conditions​

L'intégration lit https://nasstatus.faa.gov/api/airport-events toutes les 5 ou 10 minutes, une fois pour tous les aéroports suivis, et seulement quand au moins un appareil d'aéroport est créé. C'est le flux de la page NAS Status de la FAA elle-même ; il ne demande aucune clé et la FAA n'y publie aucun quota. Les aéroports absents de la réponse fonctionnent normalement.

  • Arrêt au sol (ground stop) : la FAA retient à leur départ les vols à destination de l'aéroport, le plus souvent pour des orages ou une mauvaise visibilité. L'état donne sa fin prévue.
  • Programme de retards au sol (ground delay program) : la FAA régule les vols à destination de l'aéroport et leur fixe un retard avant le décollage ; ses retards moyen et maximal comptent comme retards à l'arrivée. Un programme annoncé pour plus tard compte à partir de son début.
  • Retards au départ et à l'arrivée : signalés par l'aéroport, sous forme de fourchette (« 16–30 min ») avec une tendance.
  • Fermeture : un NOTAM qui ferme l'aéroport en ce moment. Les fermetures à horaires quotidiens (« DLY 0430-0945 ») ne comptent que pendant ces horaires ; celles qui laissent passer les vols réguliers, et les restrictions pour la seule aviation générale, sont ignorées.

Dépannage​

  • L'appareil n'a pas de valeur : créez-le dans l'onglet Découverte ; les valeurs arrivent en quelques secondes.
  • L'état de connexion dit « La FAA ne répond pas » : le flux est en panne ou injoignable depuis votre Gladys. Les dernières valeurs restent ; l'intégration réessaie à chaque intervalle et signale son retour.
  • Un aéroport n'est jamais perturbé : vérifiez son code avec État. Un aéroport hors des 77 grands apparaît rarement dans le flux.
  • Plus de détails : mettez LOG_LEVEL=debug dans l'environnement de l'intégration ; une lecture normale n'écrit rien au niveau info.

Limites​

  • La FAA couvre les États-Unis (et quelques programmes canadiens) : aucun autre pays.
  • Pas de données par vol : les retards sont ceux de l'aéroport, pas de votre vol.
  • Les restrictions pour l'aviation générale, le dégivrage et les configurations de pistes ne sont pas affichés.
  • Les noms de fonctionnalités sont fixés à la création de l'appareil.
  • Les fermetures du coucher au lever du soleil (« SS-SR ») comptent sur toute leur période.
  • Jusqu'à 20 aéroports.

Crédits​

  • Données : FAA NAS Status, service public de la Federal Aviation Administration. Cette intégration n'est ni affiliée à la FAA ni approuvée par elle.
  • Inspirée de l'intégration Home Assistant FAA Delays (Apache 2.0) et de sa bibliothèque faadelays.

Paramètres de configuration​

Voici les paramètres demandés par FAA Airport Status dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Comment ça marchesectionNonSuivez des aéroports avec l'action ci-dessous, puis créez leurs appareils dans l'onglet Découverte. Tout vient du flux ouvert NAS Status de la FAA : pas de compte, pas de clé.
Langue des textesselectNonLangue des noms de fonctionnalités, des états et des phrases envoyées à vos scènes. Les noms sont fixés à la création de l'appareil.
Fréquence de mise à jourselectNonFréquence de lecture de la FAA : une seule requête pour tous les aéroports suivis.

Comment installer FAA Airport Status dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : FAA Airport Status apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-faa:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-faa.

FAA Airport Status nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

FAA Airport Status est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le