Aller au contenu principal

Intégration domotique FEMA Disasters, gratuite et open source

Intégration FEMA Disasters pour Gladys Assistant

Déclarations de catastrophe FEMA et aides ouvertes pour votre comté américain.

Suivez depuis Gladys les déclarations de catastrophe de la FEMA, l'agence fédérale américaine de gestion des urgences, pour votre comté : ouragans, inondations, incendies, tempêtes hivernales, tornades… Quand une catastrophe frappe, le Président (catastrophe majeure, urgence) ou la FEMA (aide à la lutte contre l'incendie) la déclare pour une liste de comtés et y ouvre des programmes d'aide : l'aide aux particuliers (Individual Assistance, à demander sur DisasterAssistance.gov), l'aide publique (Public Assistance, pour les collectivités) et la réduction des risques (Hazard Mitigation).

L'intégration lit ces décisions sur OpenFEMA, les données ouvertes de la FEMA, pour le comté de votre maison ou les comtés que vous choisissez. Sans compte ni clé d'API.

Les déclarations sont des décisions administratives, souvent prises des jours après l'événement : ce n'est pas un système d'alerte de sécurité. En cas d'urgence, suivez les consignes des autorités locales et du National Weather Service. Non affiliée à la FEMA. Ce produit utilise l'API OpenFEMA de la FEMA, sans être approuvé par la FEMA.

Ce que vous obtenez​

  • Un appareil par comté : catastrophe déclarée (oui / non), type d'incident et date de la dernière déclaration, aide aux particuliers, aide publique et réduction des risques ouvertes (oui / non), et le nombre de déclarations sur 12 mois.
  • Un widget de tableau de bord : une ligne par comté, ses déclarations en cours, ses programmes, la date limite de demande et des liens vers la page FEMA de chaque catastrophe et vers DisasterAssistance.gov.
  • Deux déclencheurs de scène : une nouvelle déclaration pour votre comté, et l'aide aux particuliers ouverte (avec la date limite de demande).
  • Une action de scène qui lit les déclarations en cours en une phrase, à envoyer par message ou à faire 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 www.fema.gov, et geo.fcc.gov pour trouver le comté de votre maison).
  • Une maison aux États-Unis (les 50 États, le district de Columbia, Porto Rico et les territoires) : sa position dans Gladys (Paramètres → Maisons), ou des codes FIPS de comté saisis dans la configuration.

Configuration​

Réglages​

RéglageRôle
Codes FIPS des comtésJusqu'à 8 codes de comté à 5 chiffres, séparés par des virgules. Vide : le comté de votre maison.
Intervalle de mise à jour30 minutes, 1 heure (par défaut), 3 ou 6 heures.
Langue des noms et des messagesNoms 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 de chaque comté. Le bouton Afficher les déclarations en cours de la configuration répond tout de suite : un moyen rapide de vérifier les réglages.

Trouver votre comté​

Laissez le champ vide : l'intégration envoie une fois la position de votre maison, arrondie à trois décimales (environ 100 m), à la FCC Area API, qui renvoie son comté. Elle ne la redemande que si la position de la maison change.

Pour suivre d'autres comtés (de la famille, une résidence secondaire), saisissez leurs codes FIPS : 2 chiffres pour l'État, puis 3 pour le comté. Exemples : 12086 comté de Miami-Dade, Floride ; 06037 comté de Los Angeles, Californie ; 22071 paroisse d'Orléans, Louisiane. Le Census Bureau publie la liste des codes. Un code qu'elle ne connaît pas est ignoré et signalé dans le statut de la configuration.

Déclaration en cours​

Une déclaration concerne votre comté quand la FEMA le désigne, ou l'État entier (« Statewide »). Les déclarations tribales, faites pour des terres tribales, ne sont pas comptées. Une déclaration est en cours quand elle n'est pas clôturée et :

  • qu'elle date de moins de 30 jours ;
  • ou que sa période d'incident est encore ouverte (un incident sans date de fin compte un an au plus, 30 jours pour une aide à la lutte contre l'incendie, qui n'en reçoit jamais) ;
  • ou que les demandes d'aide aux particuliers sont encore ouvertes (jusqu'à la date limite de dépôt).

« Aide aux particuliers » est à 1 tant que les demandes d'une déclaration en cours sont ouvertes (60 jours après la déclaration tant que la FEMA ne donne pas de date limite). « Aide publique » et « Réduction des risques » sont à 1 quand une déclaration en cours les comprend.

Appareil​

FonctionnalitéTypeValeurs
Catastrophe déclaréeBinaire1 quand une déclaration est en cours
Type d'incidentTexteDernière déclaration, ex. « Ouragan · Hurricane Isaias »
Date de déclarationTexteSa date et son numéro, ex. « 27/10/2026 (DR-4955) »
Aide aux particuliersBinaire1 tant que les demandes sont ouvertes
Aide publiqueBinaire1 quand une déclaration en cours la comprend
Réduction des risquesBinaire1 quand une déclaration en cours la comprend
Déclarations sur 12 moisCompteurDéclarations faites sur les 365 derniers jours

L'appareil s'appelle « FEMA · comté, État » : renommez-le à votre guise dans Gladys. Les valeurs ne sont envoyées que lorsqu'elles changent, et de nouveau toutes les 12 heures.

Widget de tableau de bord​

Ajoutez le widget Déclarations FEMA à un tableau de bord. Il affiche le nombre de déclarations en cours, puis une ligne par comté avec une pastille rouge « Déclarée » ou verte « Aucune ». Touchez une ligne pour le détail : numéro, type et date de chaque déclaration, période d'incident, programmes, date limite de demande et liens. Le pied donne l'heure de la dernière lecture et un lien vers la page des déclarations de la FEMA (masquable dans les réglages du widget).

Déclencheurs de scène​

FEMA : nouvelle déclaration pour mon comté. Une déclaration faite dans les 90 derniers jours apparaît pour un comté suivi. Filtres : le comté (son appareil) et les types de déclaration (catastrophe majeure, urgence, lutte contre l'incendie). Variables : county_name, declaration_id (DR-4955-FL), declaration_type_name, incident_type (tel que la FEMA l'écrit, en anglais), incident_type_name, title, declaration_date, individual_assistance (vrai quand les demandes sont ouvertes), summary (une phrase) et url.

FEMA : aide aux particuliers ouverte. Les habitants d'un comté suivi peuvent demander l'aide de la FEMA : avec une nouvelle déclaration, ou plus tard, quand la FEMA modifie une déclaration pour ajouter le comté au programme. Filtre : le comté. Variables : county_name, declaration_id, incident_type_name, title, deadline (dernier jour pour faire la demande, quand la FEMA le donne), summary, url et registration_url.

Les déclarations déjà listées quand un comté commence à être suivi ne déclenchent rien : ce ne sont pas des nouvelles. Un redémarrage de l'intégration non plus.

Action de scène​

FEMA : lire les déclarations relit OpenFEMA si la dernière lecture date de plus d'un intervalle de mise à jour, et renvoie :

  • text : les déclarations en cours de chaque comté, en une phrase ;
  • active_count : le nombre de déclarations en cours ;
  • assistance_open : vrai quand les demandes d'aide aux particuliers sont ouvertes dans un comté suivi.

Exemples de scènes​

  • Prévenir la famille : sur « aide aux particuliers ouverte », envoyer {{triggerEvent.data.summary}} et le lien {{triggerEvent.data.registration_url}} par message.
  • Rappel hebdomadaire : chaque lundi, lancer « lire les déclarations », puis envoyer son texte si assistance_open est vrai.
  • Nouvelle déclaration : sur une catastrophe majeure déclarée pour votre comté, envoyer {{triggerEvent.data.summary}} et {{triggerEvent.data.url}}.

Sources des données, conditions et quotas​

  • Déclarations : jeu de données OpenFEMA « Disaster Declarations Summaries » (v2), données publiques du gouvernement américain, lues sans compte. Ce produit utilise l'API OpenFEMA de la FEMA, sans être approuvé par la FEMA. Le gouvernement fédéral et la FEMA ne garantissent ni les données ni les analyses qui en sont tirées une fois les données récupérées sur leurs sites. Voir les conditions d'OpenFEMA.
  • Comté de la maison : FCC Area API, publique, sans compte.
  • Noms et codes des comtés : US Census Bureau, codes FIPS de 2020 (le millésime qu'utilise la FEMA), fournis avec l'intégration.
  • Quotas : OpenFEMA n'en publie aucun pour cet usage. L'intégration envoie une requête par comté et par intervalle de mise à jour (toutes les heures par défaut), et une requête à la FCC quand la maison change de position.

Dépannage​

  • « Aucun comté » : indiquez la position de votre maison dans Gladys (Paramètres → Maisons), ou saisissez des codes FIPS de comté.
  • « Aucun comté américain à la position de votre maison » : la maison est hors des États-Unis (ou sa position tombe en mer) : saisissez les codes FIPS des comtés à suivre.
  • La maison a changé de comté : un nouvel appareil est proposé dans l'onglet Découverte ; supprimez l'appareil de l'ancien comté, qui ne reçoit plus de valeurs.
  • « Ignoré (pas un code FIPS de comté) » : vérifiez le code dans la liste du Census (5 chiffres, zéro initial facultatif : 6037 et 06037 désignent tous deux le comté de Los Angeles).
  • « OpenFEMA ne répond pas » : le service est en panne ou injoignable depuis la machine de Gladys. Les dernières valeurs restent ; l'intégration réessaie à chaque mise à jour et le signale une fois dans ses logs.
  • Aucun déclencheur après un changement de réglages : normal, les déclarations déjà là ne sont pas des nouvelles.
  • Les noms des fonctionnalités sont dans la mauvaise langue : ils sont fixés à la création de l'appareil. Changez la langue, 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​

  • Les déclarations sont des décisions prises après un événement, parfois des semaines plus tard : elles disent où va l'aide fédérale, pas où est le danger. Pour les alertes, voyez le National Weather Service et vos autorités locales.
  • Les centres d'aide (Disaster Recovery Centers) ne sont pas listés : la FEMA les publie sur son site et dans son application.
  • Les types d'incident sont traduits ; les intitulés des déclarations, les noms des comtés et les numéros FEMA restent en anglais.
  • Testée contre le vrai service OpenFEMA le 12/11/2026 (un comté touché, un comté calme, des codes invalides) ; pas encore dans une vraie instance de Gladys : vos retours sont les bienvenus sur le forum.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre comtésectionNonSuivez les déclarations de catastrophe FEMA de votre comté. Laissez le champ vide pour utiliser le comté de votre maison (sa position dans Gladys), ou saisissez jusqu'à 8 codes FIPS de comté. Enregistrez, puis créez les appareils dans l'onglet Découverte.
Sources et limitessectionNonDonnées OpenFEMA, lues sans compte. Les déclarations sont des décisions administratives, souvent prises des jours après l'événement : pas un système d'alerte de sécurité. Non affiliée à la FEMA.
Codes FIPS des comtésstringNon5 chiffres chacun, séparés par des virgules. Vide : le comté de votre maison.
Intervalle de mise à jourselectOui
Langue des noms et des messagesselectOuiLes noms des fonctionnalités sont fixés à la création des appareils.

Comment installer FEMA Disasters dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : FEMA Disasters 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-fema: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-fema.

FEMA Disasters 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​

FEMA Disasters 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 🙂