Intégration domotique TransLink Vancouver, gratuite et open source
Prochains passages TransLink, état du SkyTrain et stations de vélos Mobi à Vancouver.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Les prochains passages TransLink (autobus, SkyTrain, SeaBus), l'état des lignes du SkyTrain et les vélos Mobi près de chez vous, dans Gladys.
Cette intégration n'est affiliée ni à TransLink ni à Mobi by Rogers.
Démarrer en 3 étapes
Aucune connaissance technique n'est nécessaire, et aucun compte non plus pour commencer.
- 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 et les 2 stations Mobi les plus proches de chez vous y sont proposés, avec leur nom et la direction des lignes, par exemple « TransLink – Waterfront Station @ Bay 2 (50 → False Creek South) ». Cliquez sur Ajouter pour chacun de ceux qui vous intéressent.
C'est tout. Vous avez maintenant, pour chaque arrêt, les prochains passages, et pour chaque station Mobi, les vélos et les places libres.
Le message en haut de la page de configuration indique toujours la prochaine chose à faire. Par exemple : « Prêt : 3 arrêts et 2 stations Mobi à ajouter. Ouvrez l'onglet Découverte… ».
Les noms des appareils commencent par TransLink – ou Mobi –, pour les reconnaître d'un coup d'œil dans la liste des appareils de Gladys. Vous pouvez les renommer librement dans Gladys.
Une station du SkyTrain est proposée une seule fois, pour tous ses quais. Ses quais d'autobus (« Bay 1 », « Bay 2 »…) sont des arrêts à part.
Afficher les passages sur le tableau de bord
- Ouvrez le tableau de bord, puis cliquez sur Modifier.
- Ajoutez un widget et choisissez Passages TransLink.
- Choisissez l'arrêt, puis enregistrez.
Le widget Station Mobi s'ajoute de la même façon. Le widget État des lignes TransLink demande une clé TransLink (voir plus bas).
Sans clé, les horaires prévus sont marqués d'un ~ et en gris : « ~12 min » signifie « prévu dans 12 minutes ». Les passages suivis en temps réel sont en vert, sans ~.
Passer au temps réel officiel et ajouter les lignes (facultatif)
Sans clé, les passages viennent de Transitous, un service communautaire gratuit : les horaires prévus, et le temps réel quand Transitous l'a.
Avec une clé d'API TransLink, gratuite et personnelle :
- les passages viennent directement du flux temps réel de TransLink, mis à jour chaque minute ;
- l'appareil TransLink – SkyTrain et SeaBus apparaît, avec l'état des lignes Expo, Millennium et Canada, du SeaBus et du West Coast Express.
Obtenir la clé d'API TransLink (5 minutes)
- Allez sur le portail développeurs de TransLink et créez un compte (Register). Confirmez le courriel que vous recevez.
- Connectez-vous : la page de votre compte affiche votre clé d'API (API Key). Copiez-la.
- Dans Gladys, ouvrez la configuration de l'intégration. Collez la clé dans Clé d'API TransLink, puis cliquez sur Enregistrer.
- Cliquez sur Tester la clé d'API TransLink. Les deux lignes doivent afficher ✔.
- Retournez dans l'onglet Découverte et ajoutez l'appareil TransLink – SkyTrain et SeaBus.
Les libellés du portail peuvent varier légèrement.
Requêtes. Une seule lecture du flux de TransLink sert tous vos arrêts : avec les réglages par défaut, l'intégration fait environ 2 200 requêtes par jour, quel que soit le nombre d'arrêts. Le message de la page de configuration affiche l'estimation pour votre installation.
Surveiller 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 un nom de rue, de station ou le numéro de l'arrêt, par exemple « Granville Station » ou « Davie Bidwell ».
- La réponse liste les arrêts avec leur numéro et la direction de leurs
lignes, par exemple
50040 — Waterfront Station @ Bay 2 (50 → False Creek South). - Copiez le numéro (
50040) dans Arrêts, enregistrez, puis ajoutez l'arrêt dans l'onglet Découverte.
Le numéro est aussi celui inscrit sur chaque panneau d'arrêt TransLink (« Stop #50040 »).
Pour les stations Mobi, le bouton Chercher une station Mobi fonctionne de la même façon.
Pour aller plus loin
Le champ Arrêts accepte plusieurs numéros séparés par des virgules, un
filtre de lignes après @ et un nom après :.
| Saisie | Signification |
|---|---|
50040 | toutes les lignes qui passent à l'arrêt 50040 |
61935@99 | seulement la ligne 99 |
61935@99|14 | les lignes 99 et 14 |
61935@99:Bus du travail | ligne 99, affiché sous le nom « Bus du travail » |
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… : le numéro de ligne (« 99 », « Canada Line »).
- Prochains passages : un résumé, par exemple
99 3 min · 14 ~11 min.
SkyTrain et SeaBus (avec une clé) : pour chaque ligne, un état
(Normal, Perturbé, Avis ou Inconnu) et le message de l'alerte de
TransLink. Une alerte sur une seule station (ascenseur, entrée, quai
d'autobus) ne change pas l'état de la ligne.
Station Mobi : les vélos (électriques compris), les vélos électriques, les points d'ancrage libres et l'état de la station.
Une station qui disparaît du réseau Mobi affiche 0 vélo, 0 place et l'état « Retirée du réseau Mobi (saisonnier ?) », avec un point orange sur l'appareil. Elle reprend toute seule quand elle revient.
Scènes
Déclencheurs :
- Passage imminent : un passage a lieu dans moins de 1, 2, 3, 5, 10 ou 15 minutes. Exemple : « quand le 99 est à 5 minutes, allumer la lampe 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 Expo est perturbée, m'envoyer un message ».
- Station Mobi modifiée : la station n'a plus de vélos ou de places, ou en retrouve.
Actions :
- Lire les prochains passages : par exemple, un message chaque matin « Ton 99 passe dans {{minutes}} minutes ».
- Lire l'état d'une ligne : renvoie l'état, le message de TransLink et
normal(vrai ou faux).
Dépannage
| Message ou symptôme | Que faire |
|---|---|
| « indiquez l'adresse de votre maison » | Paramètres → Maisons : placez la maison sur la carte, puis enregistrez à nouveau la configuration de l'intégration. |
| « 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êt. |
| Rien dans l'onglet Découverte | Lisez le message de la page de configuration : il dit ce qui manque. |
| « TransLink a refusé la clé d'API » | Vérifiez la clé sur le portail développeurs, puis collez-la à nouveau. |
| « L'arrêt … n'est pas dans la liste des arrêts » | Vérifiez le numéro sur le panneau. Un arrêt tout nouveau arrive avec la prochaine version de l'intégration. |
| Station « Retirée du réseau Mobi » | La station n'est plus dans le réseau Mobi : elle reviendra seule. Pour en suivre une autre, voir « Chercher une station Mobi ». |
| 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. |
Vie privée, données et licences
- La position de la maison ne sert qu'à chercher les arrêts proches, dans la liste des arrêts livrée avec l'intégration : elle n'est envoyée nulle part.
- Liste des arrêts : GTFS de TransLink, livré avec l'intégration (mis à jour à chaque version).
- Passages sans clé : Transitous, un service communautaire gratuit, à partir des données de TransLink.
- Temps réel et alertes : données ouvertes de TransLink, selon les conditions d'utilisation de TransLink.
- Vélos : flux GBFS public de Mobi by Rogers.
- Code de l'intégration : licence Apache 2.0.
Paramètres de configuration
Voici les paramètres demandés par TransLink Vancouver 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 et stations Mobi près de chez vous. C’est tout : vous avez tout de suite les prochains passages et les vélos Mobi. Une clé TransLink (facultative, gratuite) ajoute le temps réel officiel et l’état des lignes. |
| Près de chez moi | section | Non | Combien d’arrêts (à moins de 600 m) et de stations Mobi (à moins de 1 km) 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 | |
| Stations Mobi près de chez moi | number | Non | |
| Temps réel et lignes (facultatif) | section | Non | Sans clé, vous avez les passages du service gratuit Transitous : les horaires prévus, et le temps réel quand Transitous l’a. Avec une clé TransLink gratuite, vous avez les prédictions officielles en temps réel et l’état des lignes du SkyTrain. L’obtenir prend 5 minutes : suivez le guide pas à pas. |
| Clé d'API TransLink | secret | Non | La clé d'API de votre compte sur le portail développeurs de TransLink. |
| Surveiller les lignes | boolean | Non | Crée un appareil « TransLink – SkyTrain et SeaBus » avec l'état des lignes Expo, Millennium et Canada, du SeaBus et du West Coast Express. |
| Passages sans clé | boolean | Non | Sans clé, afficher les passages du service gratuit Transitous. |
| Autres arrêts et stations (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. « 50040, 61935@99:Bus du travail ». |
| Stations Mobi | string | Non | Identifiants de stations Mobi, avec un nom personnalisé optionnel après : — ex. « 0201:Station de la maison ». |
| Avancé | section | Non | Les valeurs par défaut conviennent à presque tout le monde. Avec une clé TransLink, 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. |
| Rafraîchissement Mobi (s) | number | Non | Fréquence de rafraîchissement des stations Mobi, 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 TransLink Vancouver dans Gladys
- Dans Gladys, ouvrez Intégrations : TransLink Vancouver 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-translink: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-translink.
TransLink Vancouver 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
TransLink Vancouver 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