Intégration Prix carburants pour Gladys Assistant
Suivez le prix de votre carburant dans les stations-service proches de chez vous.
Publiée par prohand
- Appareils
- Version 1.0.1
- Nécessite Gladys >=4.62.0
- ★ 1
Suivez le prix du carburant que vous utilisez dans les stations-service proches de chez vous, directement dans Gladys : un appareil par station, un historique de prix, et des scènes qui peuvent vous prévenir quand le plein devient intéressant.
Les données proviennent de l'open data officiel. Aucun compte, aucune clé d'API, aucun abonnement.
| Pays | Source |
|---|---|
| France | prix-carburants.gouv.fr (licence Etalab) |
D'autres pays pourront être ajoutés dans de prochaines versions : l'intégration est construite autour d'un « fournisseur » par pays.
Ce que vous obtenez
Pour chaque station que vous ajoutez, un appareil avec deux mesures :
- Prix — le prix au litre du carburant choisi, en euros. L'historique est conservé : Gladys trace la courbe du prix dans le temps.
- Dernière mise à jour — la date à laquelle la station a déclaré ce prix (le flux national est rafraîchi toutes les 10 minutes environ, mais une station donnée ne change pas ses prix tous les jours).
L'adresse, la marque, les coordonnées GPS et la distance au code postal sont enregistrées dans les paramètres de l'appareil.
L'appareil porte le nom de l'enseigne de la station et de sa commune, par
exemple Total Access - Oullins-Pierre-Bénite - SP98. Le flux national des prix
ne publie pas cette enseigne : elle est lue dans un jeu de données de référence
du même système d'information. Une station que ce jeu de données ne connaît pas
garde un nom construit à partir de sa rue.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Choisissez votre pays (France pour l'instant).
- Renseignez votre code postal (5 chiffres en France, par exemple
35000). C'est autour de lui que les stations sont cherchées. - Réglez le rayon de recherche :
0ne garde que les stations du code postal lui-même,10km élargit aux communes voisines. - Cochez le ou les types de carburant qui vous intéressent : Gazole, SP95, SP98, E10, E85, GPLc.
- Enregistrez.
Le bouton Prévisualiser les stations proches affiche immédiatement ce que la recherche renvoie, avec les prix actuels — pratique pour ajuster le code postal ou le rayon avant d'ajouter quoi que ce soit.
Ajouter des stations
Ouvrez l'onglet Découverte : les stations trouvées y apparaissent, une entrée par station et par carburant sélectionné, par exemple « TotalEnergies - Rennes - Gazole » et « TotalEnergies - Rennes - SP98 ». Cliquez sur Ajouter pour celles que vous voulez suivre : une seule, plusieurs, ou toutes.
Seules les combinaisons réellement disponibles sont proposées : une station qui ne vend pas de GPLc n'apparaît pas dans la liste GPLc.
Une fois ajoutée, la station publie son prix immédiatement, puis à chaque rafraîchissement (une fois par heure par défaut). Le rythme est celui de l'Intervalle de rafraîchissement de l'onglet Configuration : l'intégration gère elle-même son minuteur, l'appareil n'affiche donc pas d'option d'interrogation côté Gladys. Le bouton Rafraîchir les prix maintenant force une lecture sans attendre.
Supprimer des stations
Ouvrez l'appareil dans Réglages → Appareils, puis Supprimer. L'intégration cesse aussitôt de l'interroger. La station reste visible dans l'onglet Découverte tant qu'elle correspond à votre recherche : vous pouvez la ré-ajouter plus tard.
Supprimer un carburant d'une station n'affecte pas les autres : « Rennes - Gazole » et « Rennes - SP98 » sont deux appareils indépendants.
Changer de carburant plus tard
Un appareil Gladys conserve les mesures avec lesquelles il a été créé. Le carburant fait donc partie de l'identité de l'appareil : si vous cochez un carburant supplémentaire dans la configuration, de nouvelles entrées apparaissent dans l'onglet Découverte, et vos appareils existants continuent de fonctionner sans être modifiés. Supprimez ceux dont vous n'avez plus besoin.
Idées de scènes
- Recevoir une notification quand le prix du gazole de votre station passe sous un seuil.
- Comparer deux stations sur le tableau de bord avant de partir faire le plein.
- Enregistrer le prix moyen du mois grâce à l'historique.
Dépannage
Aucune station dans l'onglet Découverte. Vérifiez le code postal (5 chiffres en France) et augmentez le rayon de recherche. Le bouton Prévisualiser les stations proches affiche le message d'erreur exact.
Le prix ne se met plus à jour. Une station peut disparaître temporairement du flux national (travaux, fermeture). Le dernier prix connu reste affiché ; consultez les logs de l'intégration, qui indiquent les stations manquantes.
Un prix vide. La station ne déclare pas ce carburant en ce moment. L'intégration conserve alors la dernière valeur connue plutôt que de trouer la courbe.
Nombre de stations limité. Le réglage Nombre maximum de stations borne la liste de découverte (20 par défaut, 50 au maximum). En ville dense, baissez-le et réduisez le rayon.
Données et licence
Les données sont publiées par le ministère de l'Économie sous licence Etalab. L'intégration interroge le jeu de données « flux instantané » et ne récupère que les stations autour de votre code postal.
Paramètres de configuration
Voici les paramètres demandés par Prix carburants dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Comment ça marche | section | Non | Choisissez votre pays, votre code postal et votre carburant, puis ouvrez l'onglet Découverte : les stations-service proches y apparaissent avec leur prix actuel. Ajoutez celles que vous voulez suivre, supprimez-les quand vous n'en avez plus besoin. Les données viennent de l'open data officiel, sans compte ni clé d'API. |
| Pays | select | Oui | Pays dont l'open data est interrogé. D'autres pays seront ajoutés dans de prochaines versions. |
| Code postal | string | Oui | Les stations sont recherchées autour de ce code postal. En France, 5 chiffres. |
| Rayon de recherche (km) | number | Non | Cherche aussi des stations autour du code postal. 0 ne garde que les stations du code postal lui-même. |
| Type de carburant | multi_select | Oui | Un appareil est proposé par station ET par carburant sélectionné, ce qui permet de suivre plusieurs carburants dans la même station. |
| Nombre maximum de stations | number | Non | Nombre de stations que l'onglet Découverte peut lister. Baissez-le en ville dense, augmentez-le à la campagne. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de rafraîchissement du prix de chaque station ajoutée. Le flux français est mis à jour environ toutes les 10 minutes ; une fois par heure suffit largement. |
Comment installer Prix carburants dans Gladys
- Dans Gladys, ouvrez Intégrations : Prix carburants 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/prohand/gladys-prixcarburants:1.0.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/prohand/gladys-prixcarburants.
Prix carburants nécessite Gladys >=4.62.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
Prix carburants 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 prohand, 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