Intégration domotique Le Vélo (TBM), gratuite et open source
Vélos et places libres des stations Le Vélo (Bordeaux), musculaires et électriques à part.
Publiée par daviddu26
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration affiche dans Gladys les vélos disponibles et les places libres des stations Le Vélo par TBM (anciennement V³ / VCub), le vélo en libre-service de Bordeaux Métropole. Les vélos musculaires et les vélos électriques sont comptés à part : vous savez avant de sortir s'il reste un vélo électrique à votre station.
Pas de compte, pas de clé : la disponibilité des stations est publiée en données ouvertes par Bordeaux Métropole.
Intégration communautaire, sans lien avec TBM, Keolis Bordeaux Métropole Mobilités ou Bordeaux Métropole.
Version bêta. Signalez tout souci ou idée sur GitHub, avec une capture d'écran si possible.
Démarrer
- Vérifiez que votre maison a une adresse dans Gladys (Paramètres → Maisons).
- Installez l'intégration, acceptez l'accès à la position de la maison, puis enregistrez la page de configuration.
- Ouvrez l'onglet Découverte de l'intégration : les stations les plus proches de chez vous y sont proposées. Cliquez sur Ajouter sur celles qui vous intéressent.
Les valeurs arrivent dans la minute.
Si vous avez plusieurs maisons, l'intégration cherche autour de la première qui a une adresse.
Ce que vous obtenez
Un appareil par station, par exemple Le Vélo – Meriadeck, avec :
| Fonctionnalité | Exemple | Remarque |
|---|---|---|
| Vélos musculaires | 10 | Vélos sans assistance |
| Vélos électriques | 5 | Vélos à assistance électrique |
| Vélos disponibles | 15 | Les deux ensemble |
| Places libres | 28 | Bornes où rendre un vélo |
| État | En service | Voir ci-dessous |
| Résumé | 10 musculaires · 5 électriques · 28 places | Prêt à mettre dans une notification |
Les compteurs gardent leur historique : Gladys peut tracer à quelle heure votre station se vide le matin.
L'état vaut En service, Location suspendue (on peut rendre mais pas emprunter), Retour impossible (on peut emprunter mais pas rendre) ou Hors service. Une station qui ne loue pas compte 0 vélo, même s'il en reste aux bornes (vélos bloqués ou en maintenance) ; une station qui ne reprend pas les vélos compte 0 place. Ainsi, une scène « moins de 2 vélos » dit vrai.
Suivre une autre station
Pour une station loin de chez vous (travail, gare…) :
- En bas de la page de configuration, cliquez sur Chercher une station et tapez une partie de son nom ou de sa rue (ex. « Saint-Jean »).
- Copiez son numéro dans le champ Stations (plusieurs numéros séparés par des virgules), puis enregistrez.
- La station apparaît dans l'onglet Découverte.
Une station ajoutée reste suivie même si vous la retirez du champ ou changez le rayon : pour l'arrêter, supprimez l'appareil dans Gladys.
Réglages
| Réglage | Par défaut | Effet |
|---|---|---|
| Stations près de chez moi | 3 | Combien de stations proposer (0 désactive la proposition) |
| Rayon de recherche (m) | 500 | Distance maximale de la maison |
| Stations | (vide) | Numéros de stations supplémentaires |
| Rafraîchissement (s) | 30 | Fréquence de lecture, 30 secondes minimum |
| Langue des valeurs | Français | Langue des noms de fonctionnalités et des textes |
Tableau de bord
Le widget Station Le Vélo affiche une station d'un coup d'œil : le nom de la station, puis trois chiffres, Musculaires, Électriques et Places libres.
- Vert : il en reste assez ; orange : il en reste peu ; rouge : il n'y en a plus ; gris : la station ne loue pas (ou ne reprend pas) en ce moment.
- Sous le nom : le temps de marche depuis la maison, puis l'heure de la dernière mise à jour, ou l'état de la station quand elle n'est pas entièrement en service (« 6 min à pied · Location suspendue »).
Pour l'ajouter : Tableau de bord → Modifier → Ajouter une box → Station Le Vélo, puis :
| Réglage | Effet |
|---|---|
| Station | La station à afficher (un appareil déjà ajouté) |
| « Peu » à partir de | Orange à ce nombre ou moins (1, 2, 3 ou 5 ; 2 par défaut) |
| Historique | Les courbes des vélos musculaires, des vélos électriques et des places libres sur 12 h, 24 h ou une semaine (aucune par défaut) |
La courbe se remplit avec le temps : elle part du moment où la station a été ajoutée.
Widget « Carte Le Vélo »
La maison et les stations sur un plan OpenStreetMap. Chaque station porte une pastille avec ses vélos musculaires, ses vélos électriques (après l'éclair) et ses places libres (après le P), dans les mêmes couleurs que le widget Station. Les pastilles se placent d'elles-mêmes pour ne pas se cacher entre elles, reliées à leur station par un trait. Sous la carte, les mêmes stations de la plus proche à pied à la plus lointaine, avec leur nom et leur temps de marche.
Pour l'ajouter : Tableau de bord → Modifier → Ajouter une box → Carte Le Vélo, puis :
| Réglage | Effet |
|---|---|
| Stations | Mes stations (celles ajoutées, par défaut) ou Près de chez moi (rayon de recherche) |
| Afficher | Tout (par défaut), Vélos seulement ou Places libres seulement |
| « Peu » à partir de | Orange à ce nombre ou moins (2 par défaut) |
La carte est une image : on ne peut pas zoomer ni cliquer dessus. Le cadrage se fait tout seul pour montrer la maison et toutes les stations (10 au plus). Le fond de plan est téléchargé une fois chez OpenStreetMap puis gardé 30 jours dans le conteneur.
Temps de marche
Le temps de marche de la maison à chaque station est calculé par les rues par Transitous, le service communautaire gratuit qu'utilise aussi l'intégration TBM. Il est demandé une seule fois par station et gardé dans le conteneur : il n'est recalculé que si l'adresse de la maison change. En attendant sa réponse (ou s'il ne répond pas), le temps affiché est une estimation à vol d'oiseau, précédée de « ≈ ».
Scènes
Les fonctionnalités sont des capteurs Gladys ordinaires : utilisez le déclencheur Changement d'état d'un appareil. Exemples :
- Vélos électriques de votre station inférieur à 1 en semaine à 8 h → notification « Plus de vélo électrique à Meriadeck, prenez le tram ».
- Le matin, envoyez le Résumé dans un message : « 10 musculaires · 5 électriques · 28 places ».
Boutons de la page de configuration
- Chercher une station : trouve une station par son nom ou sa rue, et donne son numéro.
- Tester la connexion : lit les stations et la disponibilité, et affiche l'état d'une station suivie.
Dépannage
| Message ou symptôme | Que faire |
|---|---|
| « Donnez une adresse à votre maison… » | Paramètres → Maisons : renseignez l'adresse, puis réenregistrez la configuration. |
| Rien dans l'onglet Découverte | Augmentez le rayon de recherche, ou ajoutez une station à la main. |
| « Introuvable dans Stations : … » | Vérifiez le numéro avec Chercher une station. |
| « Le service Le Vélo ne répond pas » | Panne côté opérateur : l'intégration réessaie seule et garde les stations connues. |
| « Station inconnue du service » | La station a été retirée ou renumérotée : supprimez l'appareil, ajoutez la bonne. |
Données
Disponibilité des stations : Bordeaux Métropole, jeu Station Le Vélo en temps réel au format GBFS, sous Licence Ouverte. La liste des stations est relue une fois par jour et gardée dans le conteneur ; la disponibilité de tout le réseau est lue en une seule requête toutes les 30 secondes, quel que soit le nombre de stations suivies.
Fond de carte : © les contributeurs d'OpenStreetMap, tuiles du serveur de la fondation OpenStreetMap, téléchargées une fois et gardées 30 jours dans le conteneur, comme le demandent ses règles d'usage.
Paramètres de configuration
Voici les paramètres demandés par Le Vélo (TBM) 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 stations près de chez vous. C’est tout : les vélos disponibles arrivent dans la minute. Pas de compte, pas de clé : le temps réel Le Vélo est en données ouvertes. |
| Près de chez moi | section | Non | Les stations les plus proches sont proposées dans l’onglet « Découverte », un appareil par station. |
| Stations près de chez moi | number | Non | Combien de stations parmi les plus proches sont proposées. 0 désactive la suggestion. |
| Rayon de recherche (m) | number | Non | Seulement les stations à moins de cette distance de la maison, en mètres. |
| Autres stations (facultatif) | section | Non | Pour suivre une station qui n’est pas près de chez vous (travail, école…) : trouvez son numéro avec le bouton « Chercher une station » en bas de cette page, et collez-le ici. |
| Stations | string | Non | Numéros de station, séparés par des virgules. |
| Avancé | section | Non | Les valeurs par défaut conviennent à presque tout le monde. Une seule requête sert toutes les stations. |
| Rafraîchissement (s) | number | Non | Fréquence de lecture des stations, en secondes (30 secondes minimum). L’opérateur rafraîchit ses données environ chaque minute : lire plus souvent n’apporte rien. |
| Langue des valeurs | select | Non | Langue des noms de fonctionnalités et des textes publiés. |
Comment installer Le Vélo (TBM) dans Gladys
- Dans Gladys, ouvrez Intégrations : Le Vélo (TBM) 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/daviddu26/gladys-le-velo:1.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/daviddu26/gladys-le-velo.
Le Vélo (TBM) 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
Le Vélo (TBM) 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 daviddu26, 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