Intégration domotique Compteurs vélo, gratuite et open source
Compteurs vélo des villes françaises en open data : passages par jour et par semaine, records.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.3.0
- ★ 0
Les compteurs vélo que les villes françaises publient en open data, dans Gladys : combien de cyclistes sont passés devant « votre » compteur hier, sur les 7 derniers jours, et si c'est un record. Paris, Nantes Métropole, Tours Métropole, l'agglomération de Saint-Nazaire et les routes départementales des Hauts-de-Seine. Sans compte ni clé.
Intégration non officielle, sans lien avec les villes, Eco-Counter ni les exploitants des compteurs. Aucun matériel en jeu : les cinq sources ont été vérifiées en direct le 29/10/2026, vos retours sont les bienvenus.
Ce que vous obtenez
- Un appareil par compteur ajouté (par sens de circulation quand la ville les sépare) : passages de la dernière journée complète, des 7 derniers jours, d'aujourd'hui jusqu'ici et de la dernière heure disponible (selon la ville), et l'âge de la donnée.
- Un widget « Compteurs vélo » : vos compteurs sur une ligne chacun (dernière journée complète et tendance sur une semaine), avec une courbe sur 7 jours.
- Deux déclencheurs de scène : record journalier battu, données d'un compteur en retard.
- Une action de scène : les chiffres d'un compteur, avec une phrase prête à envoyer ou à dire.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Un accès à Internet depuis Gladys : les données viennent des portails open data des villes.
- Ni compte, ni clé d'API.
Installation
- Dans Gladys, ouvrez Intégrations → Installer depuis GitHub.
- Collez l'adresse
https://github.com/guim31/gladys-compteurs-veloet validez. - Ouvrez l'intégration une fois installée : l'onglet Configuration s'affiche.
Configuration
Réglages
| Réglage | Effet |
|---|---|
| Villes | les villes dont les compteurs sont proposés dans l'onglet Découverte |
| Langue des noms | langue des noms de fonctionnalités et des phrases des scènes (français) |
| Intervalle de lecture | toutes les 30 minutes, toutes les heures (par défaut) ou toutes les 3 h |
Les noms des fonctionnalités sont figés à l'ajout d'un appareil : choisissez la langue d'abord.
Ajouter des compteurs
- Cochez une ou plusieurs villes, puis enregistrez.
- Ouvrez l'onglet Découverte : chaque compteur de ces villes ayant des données sur les 17 derniers jours y figure, sous la forme « Ville · Compteur ».
- Ajoutez à Gladys ceux qui vous intéressent. Leurs valeurs arrivent aussitôt.
Les compteurs ajoutés sont les compteurs suivis : le widget, les déclencheurs et l'action de scène les proposent. Un compteur ajouté reste lu même si vous décochez sa ville ensuite.
Vérifier
L'action État de l'onglet Configuration liste les villes lues, leur nombre de compteurs, l'heure de la dernière lecture, la dernière journée complète et la dernière erreur s'il y en a une.
Appareils
| Fonctionnalité | Sens | Villes |
|---|---|---|
| Dernière journée complète | passages du dernier jour livré en entier par la ville | toutes |
| 7 derniers jours | passages des 7 jours qui finissent par la dernière journée complète | toutes |
| Aujourd'hui jusqu'ici | passages du jour en cours déjà livrés (0 jusqu'aux premières données) | Tours, Saint-Nazaire |
| Dernière heure disponible | passages de la dernière heure livrée | Paris, Saint-Nazaire |
| Âge de la donnée | heures écoulées depuis la fin des dernières données | toutes |
Une journée n'est jamais montrée avant d'être complète : les villes livrent une fois par jour, et le jour en cours de livraison reste hors de « Dernière journée complète » et « 7 derniers jours ». Un jour absent de la source n'est pas inventé : aucun total sur 7 jours n'est alors publié tant que la semaine n'est pas de nouveau entière (Paris n'a pas de 25 octobre 2026, nuit du changement d'heure). Une journée horaire à laquelle il manque une heure n'est pas complète non plus. En attendant, la fonctionnalité garde sa dernière valeur sur une semaine entière.
Widget du tableau de bord
« Compteurs vélo » : une ligne par compteur (10 au plus), avec les passages de la dernière journée complète, « hier » ou sa date, et la tendance par rapport à la semaine d'avant (« ↗ 12 % »). En gris quand les données sont en retard. En dessous, une courbe des 7 dernières journées complètes des quatre premiers compteurs ; un réglage la masque. Le widget affiche les noms donnés dans Gladys.
Déclencheurs de scène
| Déclencheur | Se déclenche quand |
|---|---|
| Record journalier battu | une nouvelle journée complète bat la meilleure journée du compteur (historique de la ville) |
| Données d'un compteur en retard | les données ont 12 h, 1 jour, 3 jours ou 1 semaine de retard, au-delà du délai habituel |
Les deux peuvent se limiter à certains compteurs. Variables : compteur, ville, passages et jour, record précédent et son jour ; l'âge de la donnée pour un compteur en retard. Un jour signalé comme douteux par Nantes n'est jamais un record.
Action de scène
Lire les chiffres d'un compteur vélo : passages de la dernière journée complète et sa date, des 7 derniers jours (0 s'il manque un jour), la tendance en % sur la semaine d'avant (avec « Tendance connue » à 0 quand elle ne peut pas être calculée), les heures de retard, et une phrase comme « Pont Wilson : 1 934 passages à vélo le 27 oct., 11 915 sur 7 jours. ». « Journée complète connue » vaut 0 tant que le compteur n'a pas encore de journée complète.
Exemples de scènes
- Chaque matin à 9 h : lire les chiffres de votre compteur, puis envoyer la phrase sur Telegram.
- Record journalier battu : envoyer un message avec le compteur et ses passages (variables de la scène).
- Données d'un compteur en retard de 3 jours : envoyer un message, le compteur est sans doute en panne.
Données et rafraîchissement
| Ville | Portail | Pas | Publication |
|---|---|---|---|
| Paris | opendata.paris.fr (Opendatasoft) | heure | chaque matin, jusqu'à la veille |
| Nantes Métropole | data.nantesmetropole.fr (Opendatasoft) | jour | chaque matin, avec deux jours de décalage |
| Tours Métropole | data.tours-metropole.fr (Opendatasoft) | jour | en fin de matinée, avec le jour en cours |
| Saint-Nazaire | data.saintnazaireagglo.fr (Opendatasoft) | heure | chaque matin, jusqu'à ce matin-là |
| Hauts-de-Seine | opendata.hauts-de-seine.fr (Opendatasoft) | jour | chaque nuit ; un jour compte une fois le suivant là |
La « Dernière journée complète » est donc en général la veille (Paris, Tours, Saint-Nazaire),
l'avant-veille (Hauts-de-Seine) ou trois jours plus tôt (Nantes). Une requête agrégée par ville et
par lecture (une de plus pour la dernière heure à Paris et à Saint-Nazaire), et une fois par
compteur ajouté la meilleure journée de son historique, gardée ensuite dans /data. À une lecture
par heure, cela fait quelques dizaines de requêtes par jour, très en dessous des quotas des
portails pour un usage anonyme.
Dépannage
- Aucun compteur dans Découverte : vérifiez qu'une ville est cochée et enregistrée, puis lancez l'action État. Une erreur « HTTP 503 » ou « timeout » vient du portail de la ville : réessayez plus tard.
- Les valeurs ne bougent pas de la journée : c'est normal, les villes publient une fois par jour.
- Une ligne grise dans le widget : les données de ce compteur sont en retard (compteur en panne ou ville en retard).
- Pour plus de détails, réglez
LOG_LEVEL=debug: chaque lecture est alors journalisée.
Limites
- Toulouse ne met plus à jour son jeu Eco-Counter depuis juin 2025, Rennes depuis juillet 2026 ; Montpellier était indisponible pendant les tests ; Lille, Angers et Brest ne publient que des chiffres annuels ou de campagne ; Anglet change de jeu de données chaque année. Elles pourront être ajoutées dès qu'un flux quotidien existera.
- Chiffres tels que publiés par les villes (comptages Eco-Counter bruts, parfois corrigés ensuite).
- Lecture seule.
Crédits
- Données : Ville de Paris, Nantes Métropole, Syndicat des Mobilités de Touraine, Saint-Nazaire agglo – La CARENE et Département des Hauts-de-Seine, sous leurs licences ouvertes (ODbL / Licence Ouverte).
- Construite à partir du modèle officiel d'intégration Gladys.
Paramètres de configuration
Voici les paramètres demandés par Compteurs vélo dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Cochez vos villes et enregistrez : leurs compteurs vélo apparaissent dans l'onglet Découverte. Ajoutez ceux qui vous intéressent à Gladys. Sans compte ni clé. Les villes publient une fois par jour : les chiffres datent de la veille ou d'avant. |
| Villes | multi_select | Non | Compteurs vélo publiés chaque jour en open data. Autres villes : voir le guide. |
| Langue des noms | select | Non | Noms des fonctionnalités (figés à l'ajout d'un compteur) et phrases des scènes. |
| Intervalle de lecture | select | Non | Fréquence de lecture des portails. Ils publient une fois par jour, le matin. |
Comment installer Compteurs vélo dans Gladys
- Dans Gladys, ouvrez Intégrations : Compteurs vélo 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/guim31/gladys-compteurs-velo:1.0.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/guim31/gladys-compteurs-velo.
Compteurs vélo 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
Compteurs vélo 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 guim31, 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