Intégration domotique Mapbox Traffic, gratuite et open source
Trafic en temps réel sur vos trajets : durée, retard, graphique et alertes embouteillage via Mapbox.
Publiée par quentinlegay
- Appareils
- Version 1.1.2
- Nécessite Gladys >=5.1.0
- ★ 0
Suivez la durée de vos trajets habituels (maison → travail, école…) avec le
trafic en temps réel, visualisez-la en graphique et soyez prévenu en cas
d'embouteillage ou de durée anormalement longue. Les données viennent de
l'API Mapbox Directions
(profil driving-traffic).
Ce que vous obtenez
Un appareil trajet par trajet configuré (jusqu'à 3), avec :
| Fonctionnalité | Description |
|---|---|
| Durée du trajet | Durée avec le trafic actuel, en minutes (historisée → graphique) |
| Durée habituelle | Durée typique à ce moment de la semaine selon Mapbox (historisée) |
| Retard | Différence entre les deux, en minutes |
| Distance | Longueur de l'itinéraire recommandé, en km |
| Niveau de trafic | 0 fluide, 1 ralenti, 2 embouteillage, 3 bouchon important |
| Trafic | Le même niveau en texte (« Fluide », « Embouteillage »…) |
| Par | Les routes principales empruntées (« A86, A1 ») |
Plus :
- un widget de tableau de bord « Durée de trajet » : durée, retard, graphique durée actuelle vs durée habituelle, état du trafic et bouton « Actualiser » ;
- quatre déclencheurs de scène : Embouteillage sur un trajet, Fin d'embouteillage, Durée de trajet anormalement longue, Durée revenue à la normale ;
- une action de scène Obtenir la durée d'un trajet, pour envoyer par exemple chaque matin « 32 min (+7 min) · Ralenti ».
Configuration
- Créez un compte gratuit sur mapbox.com et
copiez votre jeton d'accès public par défaut (il commence par
pk.). L'offre gratuite inclut 100 000 calculs d'itinéraire par mois. - Dans l'onglet Configuration de l'intégration, collez le jeton.
- Renseignez au moins le trajet 1 :
- Nom : « Travail » par exemple ;
- Départ : laissez vide pour partir de la position de la maison définie dans Gladys (Paramètres → Maisons), ou indiquez une adresse ou des coordonnées ;
- Destination : une adresse (« 1 place de la Défense, Puteaux ») ou des coordonnées « latitude, longitude » (« 48.8924, 2.2369 », le format copié depuis Google Maps par un clic droit) ;
- Passer par (facultatif) : par défaut, Mapbox suit le chemin le plus
rapide. Pour suivre votre chemin, indiquez un ou plusieurs lieux de
passage, dans l'ordre, séparés par
;(jusqu'à 3) : un pont, une ville, un point sur la route choisie… Par exemplePont de Normandie; 49.4431, 0.3601. Choisissez des points situés sur la route voulue (pas à côté), sinon Mapbox fait un détour pour les atteindre. Cela ne coûte pas de requête supplémentaire.
- Cliquez sur Tester Mapbox : la durée actuelle du trajet 1 s'affiche sous le bouton.
- Ouvrez l'onglet Découverte et ajoutez vos trajets.
Actualisation
- Intervalle : 300 s par défaut (minimum 60 s).
- Jours actifs / Heures actives : pour n'interroger Mapbox qu'aux
heures utiles, par exemple du lundi au vendredi,
07:00-09:30, 16:30-19:00. Vides, les trajets sont actualisés en permanence. Les heures sont lues dans le fuseau horaire configuré (Europe/Parispar défaut). - Éviter : péages, autoroutes, ferries.
Offre gratuite Mapbox
L'API Directions inclut 100 000 requêtes gratuites par mois ; au-delà, Mapbox facture les requêtes supplémentaires (voir les tarifs Mapbox). L'intégration fait une requête par trajet à chaque actualisation, et ne géocode chaque adresse qu'une fois. Consommation mensuelle ≈ trajets × actualisations par heure × heures actives par jour × jours.
Par exemple, 3 trajets actualisés toutes les 5 minutes pendant 5 h par jour ouvré consomment environ 4 000 requêtes par mois, et environ 26 000 s'ils sont actualisés 24 h/24 : les deux restent dans l'offre gratuite. Actualiser 3 trajets chaque minute, 24 h/24, consomme environ 130 000 requêtes et la dépasse.
Votre consommation réelle est visible dans votre compte Mapbox.
Alertes
- Embouteillage : détecté quand au moins 10 % (réglable) de la distance est en circulation dense selon Mapbox, ou que la durée dépasse nettement la durée habituelle (+35 %).
- Durée anormalement longue : quand la durée dépasse la durée habituelle de 30 % et d'au moins 5 minutes (réglables), pour éviter les alertes sur un trajet court qui passe de 4 à 6 minutes.
Exemples de scènes
- Prévenir en cas de bouchon : déclencheur Embouteillage sur un trajet
(trajet « Travail »), action « Envoyer un message » :
Bouchon vers le travail : {{triggerEvent.data.summary}}. - Réveil adaptatif : à 7 h en semaine, action Obtenir la durée d'un trajet, puis action « Envoyer un message » en insérant la variable Résumé (ou Durée du trajet (min)) produite par l'action précédente.
- Seuil personnel : comme l'appareil est un appareil Gladys standard, le déclencheur natif « Valeur d'un appareil » fonctionne aussi : « quand Durée du trajet (Travail) > 45 ».
Les déclencheurs d'événement ne se déclenchent qu'au changement d'état (un seul « Embouteillage » tant que le bouchon dure).
Dépannage
- « Mapbox a refusé le jeton d'accès » : vérifiez le jeton sur account.mapbox.com.
- Adresse introuvable : essayez une adresse plus complète, ou des coordonnées.
- « la maison n'a pas de position » : définissez la position de la maison dans Gladys, ou renseignez le départ.
- Les logs de l'intégration (onglet Logs, ou
docker logs) détaillent chaque actualisation ; passezLOG_LEVEL=debugpour voir les requêtes (le jeton y est masqué).
Paramètres de configuration
Voici les paramètres demandés par Mapbox Traffic dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Mapbox | section | Non | Créez un compte Mapbox gratuit et copiez votre jeton d'accès public par défaut (il commence par pk.). |
| Offre gratuite Mapbox | section | Non | L'API Directions inclut 100 000 requêtes gratuites par mois ; au-delà, Mapbox facture les requêtes supplémentaires. Cette intégration fait une requête par trajet à chaque actualisation (les adresses ne sont géocodées qu'une fois). Consommation mensuelle ≈ trajets × actualisations par heure × heures actives par jour × jours. Exemples : 3 trajets toutes les 5 min, 5 h par jour ouvré ≈ 4 000 requêtes (gratuit) ; 3 trajets toutes les 5 min, 24 h/24 ≈ 26 000 (gratuit) ; 3 trajets chaque minute, 24 h/24 ≈ 130 000 (au-delà de l'offre gratuite). Utilisez les jours et heures actifs ci-dessous pour rester largement dans l'offre. |
| Jeton d'accès Mapbox | secret | Oui | |
| Langue des textes | select | Non | |
| Trajet 1 | section | Non | Un lieu est soit une adresse (« 10 rue de Rivoli, Paris »), soit des coordonnées « latitude, longitude » (« 48.8566, 2.3522 », copiées depuis Google Maps). Laissez le départ vide pour partir de la position de la maison définie dans Gladys. Laissez la destination vide pour désactiver le trajet. Pour emprunter un autre chemin que le plus rapide, indiquez des lieux de passage (un pont, une ville, une route). |
| Nom | string | Non | |
| Départ (laissez vide pour partir de votre maison) | string | Non | |
| Passer par (facultatif) | string | Non | Impose le passage par ces lieux, dans l'ordre, au lieu du chemin le plus rapide. Jusqu'à 3 lieux séparés par « ; ». |
| Destination | string | Oui | |
| Trajet 2 | section | Non | Trajet supplémentaire facultatif, même format que le trajet 1. |
| Nom | string | Non | |
| Départ (laissez vide pour partir de votre maison) | string | Non | |
| Passer par (facultatif) | string | Non | Impose le passage par ces lieux, dans l'ordre, au lieu du chemin le plus rapide. Jusqu'à 3 lieux séparés par « ; ». |
| Destination | string | Non | |
| Trajet 3 | section | Non | Trajet supplémentaire facultatif, même format que le trajet 1. |
| Nom | string | Non | |
| Départ (laissez vide pour partir de votre maison) | string | Non | |
| Passer par (facultatif) | string | Non | Impose le passage par ces lieux, dans l'ordre, au lieu du chemin le plus rapide. Jusqu'à 3 lieux séparés par « ; ». |
| Destination | string | Non | |
| Actualisation | section | Non | Les trajets ne sont actualisés que pendant les jours et heures actifs, pour économiser votre quota Mapbox. Laissez vide pour actualiser en permanence. |
| Intervalle d'actualisation (s) | number | Non | |
| Jours actifs (vide = tous les jours) | multi_select | Non | |
| Heures actives (vide = toute la journée) | string | Non | |
| Fuseau horaire | string | Non | |
| Éviter | multi_select | Non | |
| Alertes | section | Non | Un embouteillage est détecté quand au moins la part indiquée du trajet est en circulation dense. La durée est anormalement longue quand elle dépasse la durée habituelle à la fois du pourcentage et du nombre de minutes indiqués. Les deux déclenchent des scènes. |
| Embouteillage : part du trajet encombrée (%) | number | Non | |
| Anormal : plus long que d'habitude de (%) | number | Non | |
| Anormal : et au moins (min) de retard | number | Non |
Comment installer Mapbox Traffic dans Gladys
- Dans Gladys, ouvrez Intégrations : Mapbox Traffic 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/quentinlegay/gladys-mapbox-traffic:1.1.2), 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/quentinlegay/Gladys-mapbox-traffic.
Mapbox Traffic 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
Mapbox Traffic 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 quentinlegay, 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