Intégration domotique Transitous Departures, gratuite et open source
Départs des transports publics à proximité sur le tableau de bord Gladys, grâce à Transitous.
Publiée par tomgermany
- Appareils
- Version 3.3.0
- Nécessite Gladys >=5.2.0
- ★ 0
Il vous faut :
Gladys Assistant > Version 5.2 Intégration externe des départs en transit Accès Internet pour votre installation de Gladys Assistant
Example:
Résultat : six vignettes affichent dans un premier temps, une seule fois, l'arrêt le plus proche dans chaque catégorie. À savoir : l'arrêt de bus le plus proche, le ferry le plus proche, l'arrêt de transport ferroviaire le plus proche. Ensuite, le prochain départ depuis cet arrêt s'affiche. Cela signifie que s'il n'y a qu'un seul arrêt dans votre périmètre de recherche, vous obtiendrez les six prochains départs. Si plusieurs arrêts sont trouvés, ceux-ci s’affichent avec un code couleur.
Vous obtenez :
Vous recevrez une intégration externe pour Galdys Assistant. Cette intégration affiche automatiquement les 6 prochains départs des transports en commun dans un widget clair et facile à lire, qu’il s’agisse de bus, de trains, de ferries ou de tramways. Le tout dans un rayon configurable autour de votre domicile.
Configuration
- Installez l'intégration externe soit via Gladys Assistant (recommandé), soit dans Gladys Assistant avec un accès direct à GitHub.
- Une fois l'installation terminée, vérifiez que l'intégration fonctionne correctement.
- Ouvrez votre tableau de bord, passez en mode Édition, puis ajoutez-y le nouveau widget. Sélectionnez ce widget d'intégration.
- Lorsque vous ajoutez le widget à votre tableau de bord, vous devrez fournir certaines informations : a.) Votre géolocalisation comme point de départ (la prochaine phase de développement vous permettra d’importer des données depuis Gladys Assistant) b.) Le diamètre du rayon de recherche. c.) L’intervalle de rafraîchissement, par tranches de 10 minutes. d.) Un identifiant unique pour accéder à l’API sur https://transitous.org/. Cet identifiant doit être unique — par exemple, une adresse e-mail ou un site web. Il est enregistré par l'intégration uniquement dans le champ de configuration prévu à cet effet. L'intégration ne récupère ni ne consigne cet identifiant. Tout reste entre vos mains. Transitous.org utilise cet identifiant pour gérer la charge sur son infrastructure informatique. Tenez compte du fournisseur de données lorsque vous définissez ce paramètre. Nous recommandons une durée de 15 minutes.
- Après avoir renseigné ces informations, enregistrez-les et placez le widget à l'endroit de votre choix.
Plus précisément : sélectionnez soit votre domicile Galdys, soit saisissez une géolocalisation de votre choix. En dessous, vous définissez trois rayons de recherche en mètres. Cela signifie que les arrêts seront recherchés dans ces rayons. Les rayons des différents cercles sont additionnés. Si le rayon du cercle 1 est de 300 mètres et que vous entrez 200 mètres pour le cercle 2, alors le cercle 2 aura un rayon de recherche de 500 mètres:
Dans la partie inférieure, vous pouvez ensuite choisir de reprogrammer l'affichage de l'heure. L'heure actuellement affichée correspond à l'heure à laquelle Gladys Assistant démarre aujourd'hui. À l'aide du menu déroulant, vous pouvez reprogrammer l'affichage en indiquant le nombre de jours souhaité ; par exemple, 14 h plus 1 jour = demain à 14 h. L'heure est toujours calculée par rapport au moment où l'application démarre.
Ils règlent ensuite la fréquence à laquelle les nouveaux horaires de départ seront récupérés. Par respect pour le prestataire Transitous, nous vous demandons de ne pas choisir une fréquence inférieure à 30 minutes.
Enfin, Transitous demande un « connaisseur » ; nous ne conservons pas cette information (sauf dans le champ de configuration) et ne l'utilisons pas. Elle est utilisée exclusivement par Transitous :
Mode d'emploi
Sur l'image du haut, vous verrez un bouton. Celui-ci affiche les trois zones de recherche que vous avez sélectionnées, et chaque clic vous permet de passer de la zone supérieure à la zone inférieure, puis inversement.
Les résultats s'affichent dans un premier temps dans les six premières vignettes. Celles-ci indiquent : une icône représentant le mode de transport (bus, train, avion, ferry, etc.) ; en dessous, l'heure de départ et la gare de destination.
Chaque mode de transport est représenté par une couleur distincte. Les services de transport spéciaux, tels que les ferries, les téléphériques, ainsi que les services « Call-a-Taxi » et « Moonliner », sont indiqués en gris. Les trajets annulés ou perturbés sont indiqués en rouge.
Au bas de l'écran, vous verrez s'afficher la liste des arrêts détectés. Celle-ci indique dans un premier temps le nom de l'arrêt, suivi du numéro de ligne (également identifié par un code couleur), de la distance par rapport à votre position actuelle et, le cas échéant, du type de véhicule.
Sur l'image du haut, vous verrez un bouton. Celui-ci affiche les trois zones de recherche que vous avez sélectionnées, et chaque clic vous permet de passer de la zone supérieure à la zone inférieure, puis inversement.
Dépannage
L'intégration consigne toutes ses opérations : consultez les journaux d'intégration depuis l'
interface utilisateur de Gladys (ou via la commande docker logs sur l'hôte) avec l'option LOG_LEVEL=debug pour obtenir tous les
détails.
Paramètres de configuration
Voici les paramètres demandés par Transitous Departures dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Informations de configuration du widget | section | Non | Avant d’ajouter le widget à votre tableau de bord, déterminez les coordonnées du lieu choisi. Vous avez besoin de la latitude et de la longitude au format décimal, par exemple 49.350 et 8.690. Lors de l’ajout du widget, vous pourrez définir le rayon de recherche, le nombre de départs et l’intervalle d’actualisation. Le rayon de recherche par défaut est de 2 000 mètres. Données horaires : Transitous. Informations sur les sources de données et les crédits : https://transitous.org/sources/ |
Comment installer Transitous Departures dans Gladys
- Dans Gladys, ouvrez Intégrations : Transitous Departures 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/tomgermany/gladys-transitous-departures:3.3.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/tomgermany/gladys-transitous-departures.
Transitous Departures nécessite Gladys >=5.2.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
Transitous Departures 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 tomgermany, 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