Intégration domotique NASA, gratuite et open source
Astéroïdes proches, la Terre vue par EPIC et événements naturels autour de vous (NASA).
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration apporte dans Gladys trois services ouverts de la NASA : les astéroïdes géocroiseurs qui passent ces 7 prochains jours (NeoWs, données du JPL), la dernière image de la Terre entière prise par la caméra EPIC du satellite DSCOVR, à 1,5 million de km, et les événements naturels suivis par EONET autour de vos maisons : feux de forêt, tempêtes violentes, inondations, volcans, glace de mer…
Transport : cloud. L’intégration lit api.nasa.gov, epic.gsfc.nasa.gov et eonet.gsfc.nasa.gov. Elle envoie votre clé NASA, si vous en avez donné une, à api.nasa.gov seulement, et pour EONET un carré du rayon choisi autour de chaque maison localisée, jamais sa position exacte. Non affiliée à la NASA.
La distance lunaire. La distance de la Terre à la Lune, 384 400 km. La plupart des astéroïdes d’une semaine passent au-delà de 5 distances lunaires ; quelques-uns par an passent à l’intérieur de l’orbite de la Lune. Un astéroïde potentiellement dangereux (PHA) mesure plus de 140 m environ et son orbite passe à moins de 7,5 millions de km de celle de la Terre : un classement, pas un impact annoncé.
Prérequis
- Gladys 5.3.0 ou plus récent (widgets et déclencheurs de scène).
- Pour les événements naturels et la Terre face à votre maison : une maison localisée (Paramètres → Maisons). L’intégration demande les coordonnées des maisons à l’installation.
- Facultatif : une clé d’API gratuite de la NASA, demandée en une minute sur https://api.nasa.gov/ (une adresse e-mail suffit). Sans elle, la clé partagée
DEMO_KEYpermet 10 requêtes par heure et par adresse IP ; l’intégration en utilise 4 par jour.
Configuration
| Champ | Rôle |
|---|---|
| Clé d’API de la NASA (facultative) | Vide : DEMO_KEY. Une clé personnelle évite de partager un quota avec votre réseau. |
| Langue des textes | Noms des appareils, phrases des scènes et erreurs. Automatique : la langue du dernier widget. |
| Rayon autour de chaque maison | 100 à 2 000 km (500 par défaut) : jusqu’où un événement naturel compte. |
| Événements des derniers | 7, 14 ou 30 jours (14 par défaut). |
| Passage proche à moins de | 1 à 20 distances lunaires (5 par défaut) : déclencheur de passage proche et couleurs. |
Le bouton Tester la connexion lit les trois services (les astéroïdes seulement s’ils n’ont pas été lus ces 10 dernières minutes) et liste les maisons localisées. Diagnostic écrit l’état de l’intégration dans ses journaux, sans la clé ni les coordonnées.
L’intégration lit les astéroïdes toutes les 6 heures, EPIC toutes les 3 heures (une nouvelle journée d’images est publiée une fois par jour, avec un ou deux jours de retard) et EONET toutes les heures. Un échec la fait attendre plus longtemps à chaque fois (6 heures au plus) ; un quota épuisé attend une heure ; une clé refusée attend un changement de la configuration.
Utilisation
Appareils
Dans l’écran Découverte : un appareil Astéroïdes géocroiseurs (NASA), et un appareil Événements naturels par maison localisée. Créez ceux que vous voulez.
| Appareil | Fonctionnalités |
|---|---|
| Astéroïdes géocroiseurs (NASA) | Passage le plus proche des 7 prochains jours (km, et distances lunaires), passages sur 7 jours, potentiellement dangereux sur 7 jours, nom de l’astéroïde le plus proche |
| Événements naturels – maison | Nombre d’événements dans le rayon et la période, distance du plus proche (km), son titre, sa catégorie et sa distance (un texte). Sans événement, la distance garde sa dernière valeur |
Widgets du tableau de bord
- Astéroïdes géocroiseurs : le passage le plus proche (rouge sous 1 distance lunaire, orange sous le seuil), les compteurs, puis les 8 passages les plus proches ou les prochains (réglage) avec leur date, leur distance et leur taille ; une ligne ouvre ses détails et la fiche du JPL.
- La Terre vue de l’espace : choisissez un appareil Événements naturels (vide : la première maison localisée) : la dernière image EPIC dont le centre est le plus proche de la longitude de la maison, avec sa date.
- Événements naturels proches : choisissez un appareil Événements naturels : le nombre, la distance du plus proche, et les événements avec leur catégorie, leur date, leur ampleur et leur source.
Scènes
Déclencheurs (chacun part une seule fois, jamais au démarrage) :
- NASA : passage proche d’un astéroïde : un astéroïde passera plus près que le seuil dans les 7 prochains jours.
- NASA : astéroïde potentiellement dangereux : un PHA passera dans les 7 prochains jours, quelle que soit sa distance.
- NASA : événement naturel proche : un nouvel événement EONET dans le rayon d’une maison ; filtre par maison et par catégories. Changer le rayon ou la période ne déclenche jamais les événements qui entrent dans le champ.
Chaque déclencheur donne une phrase toute prête, {{triggerEvent.data.message}}, dans la langue de la configuration ; les titres des événements restent en anglais, comme la NASA les écrit.
Actions : lire les astéroïdes de la semaine, lire les événements naturels proches (une maison), lire la dernière image de la Terre (une maison), chacune avec une phrase summary ; la dernière donne aussi le lien de l’image. Elles répondent avec les dernières lectures, et ne relisent que ce qui est trop ancien.
Exemples :
- Quand passage proche d’un astéroïde (seuil : 1 distance lunaire) → envoyer la notification
{{triggerEvent.data.message}}. - Quand événement naturel proche à l’appareil Événements naturels de la maison, catégorie Feux de forêt → envoyer « Feu à {{triggerEvent.data.distance_km}} km : {{triggerEvent.data.title}} ».
- Chaque dimanche à 9 h → lire les astéroïdes de la semaine → envoyer le
summary.
Dépannage
- Aucun appareil Événements naturels : la maison n’est pas localisée (Paramètres → Maisons), puis relancez une recherche depuis l’écran Découverte.
- « api.nasa.gov refuse la clé d’API » : vérifiez la clé, ou videz le champ pour utiliser
DEMO_KEY. - « Le quota horaire d’api.nasa.gov est épuisé » :
DEMO_KEYest partagée par tous les appareils de votre adresse IP publique ; demandez une clé personnelle gratuite. - Les événements naturels restent à 0 : EONET est clairsemé hors des États-Unis ; essayez un rayon ou une période plus grands.
- L’image de la Terre date de quelques jours : EPIC publie ses images avec un ou deux jours de retard, et s’interrompt parfois plusieurs jours.
- Journaux : Paramètres → Supervision ; ajoutez
DEBUG=gladys-integration-sdken mode développeur pour les journaux du SDK. Issues : https://github.com/William-De71/gladys-nasa/issues
Paramètres de configuration
Voici les paramètres demandés par NASA dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Données ouvertes de la NASA | section | Non | Trois services gratuits de la NASA, lus par Internet (cloud) : NeoWs pour les astéroïdes (données du JPL), EPIC pour les images de la Terre entière prises depuis DSCOVR, et EONET pour les événements naturels. Seul EONET reçoit une zone autour de chaque maison localisée de Gladys (un carré du rayon ci-dessous), jamais la position exacte. NeoWs demande une clé d’api.nasa.gov : la clé partagée DEMO_KEY marche sans inscription, une clé personnelle gratuite évite de partager son quota. L’intégration lit les astéroïdes 4 fois par jour. Non affiliée à la NASA. |
| Clé d’API de la NASA (facultative) | secret | Non | Vide : la clé partagée DEMO_KEY (10 requêtes par heure et par adresse IP). Une clé gratuite d’api.nasa.gov en permet 1 000. |
| Langue des textes | select | Non | Noms des appareils, textes et erreurs des scènes. Automatique : la langue du dernier widget affiché. |
| Événements naturels | section | Non | EONET recense feux de forêt, tempêtes, inondations, volcans et autres événements à partir de plusieurs sources (GDACS, IRWIN, JTWC…). Sa couverture est inégale : très complète pour les feux des États-Unis, partielle ailleurs. Ce n’est pas un service d’alerte officiel : gardez les alertes de votre pays. |
| Rayon autour de chaque maison | select | Non | |
| Événements des derniers | select | Non | |
| Astéroïdes | section | Non | Une distance lunaire est la distance de la Terre à la Lune, 384 400 km. La plupart des passages d’une semaine restent au-delà de 5 distances lunaires ; quelques-uns par an passent à l’intérieur de l’orbite de la Lune. |
| Passage proche à moins de | select | Non | Pour le déclencheur de passage proche et les couleurs du widget des astéroïdes. |
Comment installer NASA dans Gladys
- Dans Gladys, ouvrez Intégrations : NASA apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/william-de71/gladys-nasa:0.1.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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/William-De71/gladys-nasa.
NASA 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
NASA 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 William-De71, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation