Aller au contenu principal

Intégration domotique US Wildfires, gratuite et open source

Intégration US Wildfires pour Gladys Assistant

Feux de forêt en cours près de chez vous aux États-Unis, par le NIFC : distance, surface, maîtrise.

Voir sur GitHubToutes les intégrations

Suivez depuis Gladys les feux de forêt en cours autour de votre maison aux États-Unis, avec les données officielles du National Interagency Fire Center (NIFC) : les incidents et les périmètres cartographiés de WFIGS (Wildland Fire Interagency Geospatial Services), domaine public, mis à jour toutes les quelques minutes. Sans compte ni clé d'API.

Pour chaque feu dans votre rayon : son nom, sa distance (au bord de son périmètre cartographié quand il existe), sa surface, sa maîtrise, son comté et son État.

Ce n'est pas un service d'alerte officiel : en cas d'urgence, suivez vos autorités locales, les alertes d'urgence de votre comté et les ordres d'évacuation. Non affiliée au NIFC, à l'US Forest Service ni à aucune autre agence.

Ce que vous obtenez​

  • Un appareil Feux autour de la maison : nombre de feux dans le rayon, distance du feu le plus proche, le feu le plus proche en toutes lettres et la surface brûlée totale, avec leur historique.
  • Un widget de tableau de bord qui liste les feux du plus proche au plus loin, avec leur surface et leur maîtrise.
  • Trois déclencheurs de scène : un nouveau feu dans le rayon, un feu qui approche (à moins de la distance d'alerte), un feu maîtrisé à 100 %.
  • Une action de scène qui lit les feux alentour en une phrase, à envoyer par message ou à lire à voix haute.

Prérequis​

  • Gladys Assistant 5.3 ou plus récent.
  • Un accès à Internet depuis la machine de Gladys (l'intégration lit services3.arcgis.com, le service ArcGIS du NIFC).
  • Une position pour votre maison dans Gladys (Paramètres → Maisons), ou des coordonnées saisies dans la configuration. Les données ne couvrent que les États-Unis (et Porto Rico).

Configuration​

Réglages​

RéglageRôle
Latitude et longitude du centreCentre de la zone. Laissez-les vides pour utiliser la position de votre maison. Virgule décimale acceptée.
Rayon10, 25, 50 (par défaut), 100 ou 150 miles.
Distance d'alerte1 à 25 miles (10 par défaut) : le déclencheur « Feu qui approche » part quand un feu arrive à cette distance.
Inclure les brûlages dirigésSuivre aussi les brûlages planifiés par les gestionnaires des terres (« RX »). Désactivé par défaut.
Ignorer les feux maîtrisés à 100 %Masquer les feux maîtrisés, qui restent listés jusqu'à leur extinction déclarée. Désactivé par défaut.
UnitésMiles et acres (par défaut), ou kilomètres et hectares.
Fréquence de mise à jour10, 15 (par défaut), 30 ou 60 minutes.
Langue des textesNoms des fonctionnalités (à leur création) et textes envoyés aux scènes. Français par défaut.

Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et créez l'appareil Feux autour de la maison. Le bouton Afficher les feux en cours de la configuration liste aussitôt les feux alentour : un moyen rapide de vérifier les réglages.

Les feux suivis​

Un feu est suivi quand le NIFC le liste comme en cours, que c'est un feu de forêt (ou un brûlage dirigé, si choisi) et que sa distance est dans le rayon. La distance est mesurée au bord de son périmètre cartographié quand le NIFC en a un (0 si votre maison est dedans), sinon à son point de départ. Les grands feux sont souvent bien plus proches par leur périmètre que par leur point : le feu Hagen de l'enregistrement de test est à 25 miles par son point et à 21 par son périmètre.

Vie privée : la position envoyée au NIFC est arrondie à 0,1° (environ 11 km), avec un rayon élargi d'autant ; la distance exacte est calculée dans le conteneur. La position de la maison n'est jamais écrite dans les logs ni dans /data.

Appareil​

FonctionnalitéTypeValeur
Feux dans le rayonCompteurNombre de feux suivis
Distance du feu le plus procheDistance (mi, km)Distance au feu le plus proche ; 1 000 s'il n'y en a aucun, pour qu'une condition « < 10 » tienne
Feu le plus procheTexteex. North Cayuse · 15 mi · 4 887 acres · maîtrisé à 97 % · Umatilla, OR
Surface brûlée totaleSurface (km²)Surface des feux suivis. Gladys n'a pas d'unité acre : 1 km² vaut 247 acres

L'unité de la distance est celle du réglage Unités à la création de l'appareil ; elle ne change plus ensuite (supprimez et recréez l'appareil pour la changer). Quand le NIFC ne répond pas, rien n'est publié : les dernières valeurs restent, et l'écran de configuration le signale. Les valeurs sont lues dans le conteneur à chaque intervalle : l'appareil n'est pas interrogé par Gladys.

Widget de tableau de bord​

Feux alentour : un titre avec le nombre de feux, puis jusqu'à 8 feux, du plus proche au plus loin. Chaque ligne donne le nom, la distance, la surface et le comté, et la maîtrise en pastille (verte à 100 %). Touchez une ligne pour voir la date de découverte, la cause, l'identifiant NIFC et une carte de l'emplacement du feu. Les distances suivent les unités de votre compte Gladys. Le pied indique la source et l'heure de la dernière lecture ; le bouton InciWeb (actualités des incidents) se masque dans les réglages du widget.

Déclencheurs de scène​

Feux US : nouveau feu dans le rayon se déclenche quand un feu jamais vu entre dans le rayon. Filtre : types d'incident (feu de forêt, brûlage dirigé).

Feux US : feu qui approche se déclenche quand un feu arrive à moins de la distance d'alerte de la configuration, nouveau feu compris. Filtre : types d'incident.

Feux US : feu maîtrisé à 100 % se déclenche quand un feu suivi atteint 100 % de maîtrise.

Chaque déclencheur part une fois par feu : un périmètre redessiné de part et d'autre de la distance d'alerte ne le relance pas. Les feux déjà listés au tout premier démarrage, ou quand vous changez la configuration, ne déclenchent rien : ce n'est pas une nouvelle. Ce qui a été vu est conservé dans /data : un redémarrage ne déclenche rien pour les feux déjà vus. Au plus 20 événements par mise à jour.

Variables des trois déclencheurs : name, incident_type (wildfire, prescribed), distance et distance_unit (mi ou km), area et area_unit (acres ou ha), containment (pourcentage, vide quand le NIFC ne le dit pas), state (CA, OR…), county, cause (Human, Natural, Undetermined, tel que publié) et summary (une ligne, comme la fonctionnalité Feu le plus proche).

Action de scène​

Feux US : lire les feux alentour relit le NIFC si la dernière lecture date de plus d'un intervalle, puis renvoie :

  • text : les feux en une phrase, ex. 5 feux à moins de 50 mi : North Cayuse, à 15 mi ; Hagen, à 21 mi ; Dorran Road, à 22 mi ; 1924, à 35 mi ; Paradise, à 41 mi. (5 feux au plus, puis « et N de plus ») ;
  • count : le nombre de feux.

Exemples de scènes​

  • Message quand un feu approche : déclencheur « Feux US : feu qui approche », action « Envoyer un message » avec {{triggerEvent.data.summary}}.
  • Point du matin en saison des feux : chaque jour à 7 h 30, « Feux US : lire les feux alentour », puis « Envoyer un message » avec son text, seulement si count est supérieur à 0.
  • Fermer les fenêtres et couper la ventilation : quand « Distance du feu le plus proche » passe sous 10, éteindre la VMC et envoyer un rappel pour fermer les fenêtres (fumée).
  • Bonne nouvelle : sur « Feux US : feu maîtrisé à 100 % », envoyer \{\{triggerEvent.data.name\}\} est maîtrisé.

Sources, conditions et quotas​

  • Données : NIFC, couches WFIGS « Incident Locations Current » et « Interagency Perimeters Current », domaine public, lues depuis les données ouvertes du NIFC sans compte. Les incidents viennent d'IRWIN, le système commun des agences de lutte fédérales, des États et locales.
  • Les données sont saisies par les agences, parfois en retard : un nouveau feu peut apparaître avec un délai, la surface et la maîtrise sont les dernières déclarées, les petits feux n'ont souvent pas de périmètre, et un feu reste « en cours » jusqu'à son extinction déclarée. Elles ne remplacent jamais les alertes et ordres d'évacuation de vos autorités locales. Voir Ready.gov pour se préparer.
  • Quotas : le NIFC n'en publie pas pour ces couches publiques. L'intégration fait deux requêtes par intervalle (15 minutes par défaut), limitées à la zone autour de votre maison, avec des périmètres simplifiés (précision d'environ 200 m) : quelques dizaines de kilo-octets par cycle.

Dépannage​

  • « Aucun centre » dans la configuration : indiquez la position de votre maison dans Gladys (Paramètres → Maisons), ou saisissez des coordonnées.
  • « Le NIFC ne répond pas » : le service ArcGIS est en panne ou injoignable depuis la machine de Gladys. Les dernières valeurs restent ; l'intégration réessaie à chaque intervalle et le dit une fois dans ses logs.
  • Aucun feu : vérifiez que le centre est aux États-Unis, et élargissez le rayon ; hors saison des feux, il peut tout simplement n'y en avoir aucun.
  • Trop de petits feux sans intérêt : activez « Ignorer les feux maîtrisés à 100 % » et laissez les brûlages dirigés désactivés.
  • Aucun déclencheur après un changement de réglages : normal, les feux déjà là ne sont pas une nouvelle.
  • Noms des fonctionnalités dans la mauvaise langue, ou distance dans la mauvaise unité : ils sont fixés à la création de l'appareil. Changez le réglage, supprimez l'appareil, puis recréez-le depuis l'onglet Découverte.
  • Logs : page de l'intégration dans Gladys, onglet Logs. LOG_LEVEL=debug donne une ligne par lecture.

Limites​

  • États-Unis et Porto Rico seulement : WFIGS ne couvre ni le Canada ni le Mexique.
  • La distance est mesurée au périmètre cartographié, qui peut dater d'un jour ou plus ; entre deux cartographies, un feu rapide peut être plus près qu'affiché. Les petits feux n'ont qu'un point.
  • La surface, la maîtrise et la cause sont celles déclarées par les agences : elles peuvent être en retard sur le terrain.
  • Le NIFC ne publie pas la page InciWeb d'un incident : le widget renvoie vers l'accueil d'InciWeb.
  • Testée contre le vrai service du NIFC (enregistrement du 7 novembre 2026 autour de Pendleton, Oregon), pas sur un vrai feu près d'une maison Gladys : les retours sont les bienvenus sur le forum.

Paramètres de configuration​

Voici les paramètres demandés par US Wildfires dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre zonesectionNonLes feux de forêt du National Interagency Fire Center dans un rayon autour de votre maison (ou de coordonnées). Enregistrez, puis créez l'appareil dans l'onglet Découverte.
Sources et limitessectionNonDonnées : NIFC WFIGS, domaine public, lues sans compte. Pas un service d'alerte officiel : suivez vos autorités locales et les alertes d'urgence. Non affiliée au NIFC.
Latitude du centrestringNonLaissez les deux coordonnées vides pour utiliser la position de votre maison dans Gladys.
Longitude du centrestringNonDegrés décimaux, négatifs aux États-Unis (ouest).
RayonselectNonFeux dont le périmètre (ou la position, faute de périmètre cartographié) est à moins de cette distance.
Distance d'alerteselectNonLe déclencheur de scène « Feu qui approche » se déclenche quand un feu arrive à moins de cette distance.
Inclure les brûlages dirigésbooleanNonBrûlages planifiés par les gestionnaires des terres (« RX »). Plus de la moitié des incidents en automne.
Ignorer les feux maîtrisés à 100 %booleanNonUn feu reste listé des semaines après avoir atteint 100 % de maîtrise, jusqu'à son extinction déclarée.
UnitésselectNonDes textes et de la distance (fixée à la création de l'appareil). La surface est en km².
Fréquence de mise à jourselectNonLe NIFC met à jour les incidents toutes les quelques minutes ; les périmètres quand ils sont recartographiés.
Langue des textesselectNonNoms des fonctionnalités (à leur création) et textes envoyés aux scènes.

Comment installer US Wildfires dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : US Wildfires 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-wildfires-us: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-wildfires-us.

US Wildfires nécessite Gladys >=5.3.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​

US Wildfires 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