Intégration domotique Calgary Transit, gratuite et open source
Prochains passages des autobus et du CTrain de Calgary Transit en temps réel, et l'état du CTrain.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Les prochains passages de Calgary Transit (autobus et CTrain) en temps réel et l'état des lignes du CTrain près de chez vous, dans Gladys.
Cette intégration n'est pas affiliée à Calgary Transit ni à la Ville de Calgary.
Démarrer en 3 étapes
Aucune connaissance technique n'est nécessaire, et aucun compte : il n'y a rien à créer, aucune clé.
- Vérifiez l'adresse de votre maison dans Gladys : Paramètres → Maisons. La maison doit avoir une position sur la carte. L'intégration s'en sert pour trouver les arrêts proches de chez vous. La position reste dans votre Gladys.
- Installez l'intégration depuis le catalogue des intégrations, et acceptez l'accès à la position de la maison. Ouvrez sa page de configuration et cliquez sur Enregistrer, sans rien remplir.
- Ouvrez l'onglet Découverte de l'intégration. Les 3 arrêts les plus proches de chez vous y sont proposés, avec leur nom et la direction des lignes, par exemple « Calgary Transit – NB 1 ST SW @ 8 AV SW (22 → Richmond Rd SW, 66 → Lakeview) », ainsi que l'appareil Calgary Transit – CTrain. Cliquez sur Ajouter pour chacun de ceux qui vous intéressent.
C'est tout. Vous avez maintenant les prochains passages de chaque arrêt et l'état des lignes du CTrain.
Le message en haut de la page de configuration indique toujours la prochaine chose à faire. Par exemple : « Prêt : 3 arrêts et les lignes à ajouter. Ouvrez l'onglet Découverte… ».
Les noms des appareils commencent par Calgary Transit –, pour les retrouver d'un coup d'œil dans la liste des appareils de Gladys. Vous pouvez les renommer librement dans Gladys.
Afficher les passages sur le tableau de bord
- Ouvrez le tableau de bord, puis cliquez sur Modifier.
- Ajoutez un widget et choisissez Passages Calgary Transit.
- Choisissez l'arrêt, puis enregistrez.
Le widget État du CTrain s'ajoute de la même façon.
D'où viennent les passages
Calgary Transit publie ses prédictions en temps réel en accès libre, pour les autobus et le CTrain : l'intégration les lit chaque minute, pour tous vos arrêts d'un coup. La direction de chaque passage (« → Richmond Rd SW ») vient de Transitous, un service communautaire gratuit.
Une station du CTrain a un arrêt par quai, un par sens : « EB City Hall/Bow Valley College » (vers l'est) et « WB City Hall/Bow Valley College » (vers l'ouest).
Suivre d'autres arrêts (travail, école…)
Pour un arrêt loin de chez vous :
- En bas de la page de configuration, cliquez sur Chercher un arrêt. Tapez une rue, une station ou le numéro de l'arrêt, par exemple « City Hall » ou « 1 St SW 8 Av ».
- La réponse liste les arrêts avec leur numéro et la direction de leurs
lignes, par exemple
5299 — NB 1 ST SW @ 8 AV SW (22 → Richmond Rd SW, 66 → Lakeview). - Copiez le numéro (
5299) dans Arrêts, enregistrez, puis ajoutez l'arrêt dans l'onglet Découverte.
Le numéro est celui écrit sur chaque panneau d'arrêt de Calgary Transit (celui qu'on envoie par texto au 74500).
Pour aller plus loin
Le champ Arrêts accepte plusieurs numéros séparés par des virgules, un
filtre de ligne après @ et un nom après :.
| Saisie | Signification |
|---|---|
5299 | toutes les lignes qui passent à l'arrêt 5299 |
5299@22 | la ligne 22 seulement |
5299@22|66 | les lignes 22 et 66 |
5299@22:Bus du travail | la ligne 22, affichée « Bus du travail » |
6831@202 | la ligne bleue à City Hall, vers l'est |
Ce que contient chaque appareil
Arrêt :
- Prochain passage, Passage 2… : les minutes d'attente. 999 signifie qu'aucun passage n'est prévu.
- Ligne du prochain passage… : la ligne (« 22 », « 201 » pour la ligne rouge, « 202 » pour la ligne bleue).
- Prochains passages : un résumé, par exemple
22 3 min · 66 11 min.
CTrain : pour chaque ligne (rouge, bleue), un état (Normal,
Perturbé, Avis ou Inconnu) et le message de l'alerte de Calgary
Transit. Une fermeture entre deux stations, avec des navettes d'autobus, est
une perturbation ; un détour ou toute autre annonce est un avis. Les
ascenseurs, les escaliers mécaniques et les alertes sur une seule station ne
changent pas l'état d'une ligne.
Scènes
Déclencheurs :
- Passage imminent : un passage passe sous 1, 2, 3, 5, 10 ou 15 minutes. Exemple : « quand le 22 est à 5 minutes, allumer la lumière de l'entrée ».
- État d'une ligne modifié : une ligne est perturbée, revient à la normale, ou reçoit un avis. Exemple : « si la ligne rouge est perturbée, m'envoyer un message ».
Actions :
- Lire les prochains passages : par exemple un message chaque matin « Votre 22 passe dans {{minutes}} minutes ».
- Lire l'état d'une ligne : renvoie l'état, le message de Calgary Transit
et
normal(vrai ou faux).
En cas de problème
| Message ou symptôme | Que faire |
|---|---|
| « renseignez l'adresse de votre maison » | Paramètres → Maisons : placez la maison sur la carte, puis enregistrez de nouveau la configuration. |
| « Gladys n'a pas partagé la position de votre maison » | Réinstallez l'intégration et acceptez l'accès à la position, ou tapez des numéros d'arrêts. |
| Rien dans l'onglet Découverte | Lisez le message de la page de configuration : il dit ce qui manque. |
| « L'arrêt … n'est pas dans la liste des arrêts Calgary Transit » | Vérifiez le numéro sur le panneau. Un arrêt tout neuf arrive avec la prochaine version de l'intégration. |
| Un arrêt reste à 999 | Aucun passage prévu (la nuit), ou un filtre de ligne qui ne correspond à aucune ligne de l'arrêt. |
| Un passage n'a pas de direction | Transitous ne connaissait pas encore ce trajet : la direction revient dans la journée. |
Vie privée, données et licences
- La position de la maison sert seulement à chercher les arrêts proches, dans la liste d'arrêts livrée avec l'intégration : elle n'est envoyée nulle part.
- Liste des arrêts, temps réel et alertes : données de Calgary Transit, données ouvertes de la Ville de Calgary, sous la Open Government Licence – City of Calgary (la liste des arrêts est mise à jour à chaque version).
- Directions : Transitous, un service communautaire gratuit, à partir des données de Calgary Transit.
- Code de l'intégration : licence Apache 2.0.
Paramètres de configuration
Voici les paramètres demandés par Calgary Transit dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Démarrer en 2 minutes | section | Non | 1. Vérifiez que votre maison a une adresse dans Gladys (Paramètres → Maisons). 2. Enregistrez cette page. 3. Ouvrez l’onglet « Découverte » de cette intégration et cliquez sur « Ajouter » sur les arrêts près de chez vous. C’est tout : vous avez tout de suite les prochains passages. Le temps réel Calgary Transit et l’état des lignes sont inclus, sans aucune clé. |
| Près de chez moi | section | Non | Combien d’arrêts (à moins de 600 m) parmi les plus proches sont proposés dans l’onglet « Découverte ». 0 désactive la suggestion. |
| Arrêts près de chez moi | number | Non | |
| Lignes | section | Non | L’état des lignes rouge et bleue du CTrain, d’après les alertes de service Calgary Transit. |
| Surveiller les lignes | boolean | Non | Crée un appareil « Calgary Transit – CTrain » avec l'état des lignes rouge et bleue du CTrain. |
| Autres arrêts (facultatif) | section | Non | Pour surveiller un arrêt qui n’est pas près de chez vous (travail, école…) : tapez son numéro, inscrit sur le panneau de l’arrêt, ou trouvez-le avec le bouton « Chercher un arrêt » en bas de cette page. |
| Arrêts | string | Non | Numéros d'arrêt. Filtre de lignes optionnel après @ et nom personnalisé après : — ex. « 6831, 5299@22:Bus du travail ». |
| Avancé | section | Non | Les valeurs par défaut conviennent à presque tout le monde. Une seule lecture du flux temps réel sert tous les arrêts. |
| Rafraîchissement des passages (s) | number | Non | Fréquence de rafraîchissement des passages, en secondes. |
| Rafraîchissement des lignes (s) | number | Non | Fréquence de rafraîchissement de l'état des lignes, en secondes. |
| Passages par arrêt | number | Non | Nombre de prochains passages exposés en fonctionnalités par arrêt. |
| Langue des valeurs | select | Non | Langue des noms de fonctionnalités et des textes publiés. |
Comment installer Calgary Transit dans Gladys
- Dans Gladys, ouvrez Intégrations : Calgary Transit 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/lm1lc3n7/gladys-calgary-transit:0.1.1), 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/LM1LC3N7/gladys-calgary-transit.
Calgary Transit 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
Calgary Transit 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 LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation