Aller au contenu principal

Intégration domotique Fuel prices Spain & Italy, gratuite et open source

Intégration Fuel prices Spain & Italy pour Gladys Assistant

Prix des carburants des stations d’Espagne et d’Italie, données ouvertes officielles, sans compte.

Le prix des carburants dans les stations d’Espagne et d’Italie, d’après les données ouvertes officielles des deux gouvernements, sans compte ni clé. Sans lien avec ces ministères.

Ce que vous obtenez​

  • Les stations autour de votre maison (ou dans une commune) listées dans l’onglet Découverte : ajoutez celles que vous utilisez, chacune devient un appareil avec ses prix.
  • Un appareil Carburant le moins cher : pour chaque carburant suivi, le prix le plus bas dans le rayon, la station et sa distance.
  • Un déclencheur de scène Baisse du prix d’un carburant et un widget Prix des carburants pour le tableau de bord.

Prérequis​

  • Gladys Assistant 5.3.0 ou plus récent.
  • Un accès à Internet depuis Gladys (les sources sont les serveurs des ministères).
  • Votre maison placée dans Gladys (Paramètres → Maisons), ou une commune dans la configuration. À l’installation, Gladys demande votre accord pour partager la position de la maison avec l’intégration : elle ne sert qu’à mesurer des distances, dans le conteneur.

Installation​

Dans Gladys, Intégrations → Installer depuis GitHub, adresse https://github.com/guim31/gladys-fuel-es-it.

Configuration​

  • Pays : Espagne ou Italie (un par installation).
  • Carburants à suivre : Espagne : sans plomb 95 et 98, gazole (Gasóleo A), gazole premium, GPL. Italie : essence et gazole, libre-service et servi séparés, GPL, méthane (au kg). Seuls les carburants du pays choisi sont utilisés.
  • Rayon de recherche : 1 à 30 km autour de la première maison placée dans Gladys (5 km par défaut).
  • Commune (facultatif) : ses stations sont aussi listées, et sans maison placée le prix le plus bas y est cherché. Majuscules et accents sans importance (Alcala de Henares, ROMA).
  • Langue des noms : noms des appareils et fonctionnalités, écrits une fois à l’ajout d’un appareil, dates et textes du déclencheur.

Ouvrez ensuite Découverte : l’appareil du moins cher vient en premier, puis les stations de la plus proche (50 au plus), puis celles de la commune.

Appareils​

Station​

Un par station ajoutée : le prix de chaque carburant suivi qu’elle vend (€/l, €/kg pour le méthane), la dernière mise à jour des prix (heure locale du pays) et les horaires en Espagne. Une station qui vend un nouveau carburant affiche Mettre à jour dans Découverte. Une station qui sort de la liste officielle (fermée) garde ses dernières valeurs, et le widget le signale.

Carburant le moins cher​

Pour chaque carburant suivi : le prix le plus bas dans le rayon, la station et sa distance en km (sans maison placée : dans la commune, sans distance). Les stations espagnoles réservées à leurs membres (coopératives) ne comptent jamais.

Scènes​

Prix sous un seuil​

Une scène Gladys ordinaire : déclencheur Changement de valeur d’un appareil sur une fonctionnalité de prix, condition « inférieur à 1,60 ». Cela marche pour une station comme pour l’appareil du moins cher.

Baisse du prix d’un carburant​

Le déclencheur de l’intégration : un prix baisse sur une station ajoutée dans Gladys, ou sur l’appareil du moins cher. Filtres : l’appareil et les carburants (vide : n’importe lequel). Les actions suivantes peuvent lire {{triggerEvent.data.fuel_name}}, station, price, previous_price et drop (en €). Le premier prix vu après l’ajout d’un appareil est seulement mémorisé.

Tableau de bord​

Widget Prix des carburants​

Les prix d’une station ajoutée dans Gladys, ou par défaut ceux de l’appareil du moins cher, une tuile par carburant (six au plus). Détails, masquables par un réglage : la station et la distance de chaque prix le plus bas, ou les horaires d’une station.

Actions​

Tester la liste officielle des prix : lit la liste tout de suite, et donne le nombre de stations trouvées et le prix le plus bas.

Données et limites​

  • Espagne : service REST du ministère de la Transition écologique (Geoportal Gasolineras), mis à jour toutes les 30 minutes. L’intégration lit les provinces de vos stations toutes les 30 minutes, et la liste complète (12 Mo, lue au fil de l’eau) une fois par jour.
  • Italie : données ouvertes du ministère des Entreprises et du Made in Italy (MIMIT), deux fichiers par jour avec les prix en vigueur la veille à 8 h. Ils sont demandés toutes les 2 heures et téléchargés seulement s’ils sont nouveaux. Pas d’horaires dans cette source.
  • Les prix sont ceux que les stations déclarent aux ministères : une station en retard sur sa déclaration montre un ancien prix (voir la dernière mise à jour).
  • Un pays et une maison par installation. Développée sans station à soi : retours bienvenus.

Dépannage​

  • « Aucun lieu de recherche » : placez votre maison dans Gladys, ou saisissez une commune, puis enregistrez à nouveau la configuration.
  • Aucune station dans Découverte : élargissez le rayon, vérifiez l’orthographe de la commune (son nom dans la liste officielle : Roma, Milano), puis lancez Tester la liste officielle des prix.
  • « La liste officielle des prix est illisible » : le serveur du ministère est en panne ou lent ; l’intégration réessaie toutes les 30 minutes.
  • Journaux : LOG_LEVEL=debug montre chaque lecture.

Crédits​

Données : Ministerio para la Transición Ecológica y el Reto Demográfico (Espagne) et Ministero delle Imprese e del Made in Italy (Italie), données ouvertes. Inspirée des intégrations Home Assistant de la communauté pour ces sources. Sans lien avec ces ministères.

Paramètres de configuration​

Voici les paramètres demandés par Fuel prices Spain & Italy dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Données ouvertes officiellessectionNonEspagne : la liste du ministère, mise à jour toutes les 30 minutes. Italie : les fichiers du MIMIT, une fois par jour (prix de la veille). Les stations sont cherchées autour de la maison placée dans Gladys et/ou dans une commune. Sans lien avec ces ministères.
PaysselectOuiLe pays des stations suivies.
Carburants à suivremulti_selectNonSeuls les carburants du pays choisi sont utilisés. Italie : prix en libre-service et servi séparés.
Rayon de recherche (km)numberNonAutour de la maison placée dans Gladys : les stations listées dans Découverte et le prix le plus bas.
Commune (facultatif)stringNonSes stations sont aussi listées. Sans maison placée, le prix le plus bas y est cherché.
Langue des nomsselectNonNoms des appareils et fonctionnalités (figés à l’ajout d’un appareil), dates et textes du déclencheur.

Comment installer Fuel prices Spain & Italy dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Fuel prices Spain & Italy apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-fuel-es-it: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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-fuel-es-it.

Fuel prices Spain & Italy 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​

Fuel prices Spain & Italy 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.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂