Introduzione
Carburanti Italia nasce in un periodo in cui i costi alla pompa sembrano non voler dare tregua; oggi, l’arma migliore nelle mani dei consumatori è l’informazione. Per questo motivo, siamo orgogliosi di presentarvi questo nuovo progetto firmato Domusteck, sviluppato per aiutarvi a gestire le spese e trovare convenienza ogni volta che dovete fare rifornimento.
L’idea alla base del progetto
L’idea nasce dalla necessità di avere dati certi e aggiornati direttamente sulla propria dashboard di Home Assistant. Invece di consultare decine di app diverse, potrete visualizzare i prezzi della vostra zona (o di una città specifica) in tempo reale, grazie ai dati ufficiali del Mimit (Ministero delle Imprese e del Made in Italy).
Cosa puoi fare con questa integrazione?
- Monitoraggio costante: Visualizza i prezzi di Benzina, Diesel, GPL e Metano.
- Top 20 Prezzi: Crea classifiche automatiche per vedere istantaneamente dove costa meno nella tua città..
- Automazioni intelligenti: Ricevi notifiche quando il distributore sotto casa abbassa i prezzi o quando il costo scende sotto una certa soglia.
- Dashboard personalizzate: Grazie alla potenza di Home Assistant, puoi integrare queste informazioni in card eleganti e funzionali.
Installazione e Configurazione
Metodo 1:
- Vai su HACS > Integrazioni;
- Clicca in alto a destra sui 3 puntini;
- Seleziona la voce Archivi digitali personalizzati;
- Aggiungi il Repository personalizzato: https://github.com/domusteck/domusteck-carburanti_italia
- Seleziona come tipo Integrazione;
- Clicca sulla scritta AGGIUNGI;
- Cerca Carburanti Italia;
- Premi il tasto Scarica in Basso a destra della pagina che si aprirà;
- Riavvia Home Assistant.
Metodo 2 (guidato)
- Seleziona Open Link;
- Alla richiesta di aggiungere un archivio personale digitalizzato premi AGGIUNGI;
- Clicca la voce SCARICA in basso a destra;
- Al nuovo popup che comparirà seleziona nuovamente SCARICA;
- Riavvia Home Assistant
Configurazione del Custom Component
Dopo il riavvio, attiva l’integrazione per collegarla alla tua posizione GPS nel seguente modo:
- Vai in Impostazioni > Dispositivi e Servizi;
- Clicca su Aggiungi Integrazione (in basso a destra);
- Digita Carburanti Italia e selezionalo dall’elenco;
- Apparirà una finestra di configurazione;
- Digita nel campo City il nome completo della Città;
- Nel campo province inserisci la sigla della città;
- In fuel_type seleziona il tipo di carburante da monitorare
Al termine verranno create 22 entità andiamole a scoprire:
- sensor.carburanti_nomecittà_numero_stazioni: indica il numero di stazioni che sono state trovate sul sito mise.gov.it per avere un confronto reale sui dati scaricati;
- sensor.carburanti_nomecittà_top_20: il sensore se analizzato nella sezione Impostazioni -> Strumenti per gli sviluppatori -> Stati, darà come attributi tutti i distributori ordinati in ordine crescente di prezzo, per il carburante selezionato e l’indirizzo su come raggiungerlo.
- sensor.nomecittà_stazione_1–20: indica le singole stazioni di carburante create per le ntegrazioni in eventuali automazioni.
Dashboard Temporanea
Anche se è in elaborazione la creazione di una card personalizzata, puoi prendere spunto da questa markdown copiando il seguente codice in una scheda manuale:
type: sections
max_columns: 4
title: Carburanti Italia
path: carburanti_italia
icon: mdi:currency-usd
sections:
- type: grid
cards:
- type: markdown
content: |2-
| Distributore | Prezzo | Indirizzo |
| :--- | :---: | :--- |
{% set stations = state_attr('sensor.carburanti_foggia_top_20', 'stations') %}
{% for s in stations[:20] %}
{% set brands = ['Eni Station', 'Agip Eni', 'Q8 Easy', 'Total Erg', 'Aerre Petroli', 'Eni', 'Agip', 'Tamoil', 'Energas', 'IP', 'Esso', 'Q8', 'Coop'] %}
{% set ns = namespace(found_brand='') %}
{% for b in brands %}
{% if s.address.startswith(b) %}
{% set ns.found_brand = b + ' ' %}
{% endif %}
{% endfor %}
{% set name_clean = s.name | regex_replace(find='^[0-9]+\\s+', replace='') %}
{% set addr = s.address.replace(ns.found_brand.strip() + ', ', '')
.replace(', Foggia, Puglia, 71121, Italia', '')
.replace(', Foggia, Puglia, 71122, Italia', '')
.replace(', Foggia, Puglia, 71100, Italia', '')
.replace(', Italia', '') %}
| **{{ ns.found_brand }}{{ name_clean[:15] }}** | **{{ s.price }}€** | <small>{{ addr[:35] }}</small> |
{% endfor %}
title: ⛽ Top 20 CarburantiOvviamente bisogna apportare delle piccole modifiche sulle righe:
- 13 : sostituisci il sensore top 20 con quello della tua città
- 24 – 25 – 26 : Sostituisci il nome della Città, regione e CAP adatti.
La card avrà un aspetto simile a questo:
Conclusione
L’integrazione Carburanti Italia è un progetto ancora giovane, nato dall’esigenza di portare in Home Assistant una funzione utile e finora utilizzata con le integrazioni Resful, permettendo di avere prezzi carburante aggiornati, ordinati e integrabili in qualsiasi dashboard. Proprio perché si tratta di una soluzione nuova, è possibile che in alcune situazioni emergano piccoli difetti, comportamenti inattesi o margini di ottimizzazione.
Ed è qui che entra in gioco la community.
Ogni suggerimento, segnalazione o idea di miglioramento è non solo ben accetto, ma fondamentale per far crescere questa integrazione e renderla sempre più completa, stabile e utile per tutti. Se hai proposte, richieste o vuoi contribuire allo sviluppo, puoi farlo: il tuo feedback farà davvero la differenza.
Ti potrebbe interessare anche…
Se hai trovato utile questa integrazione per Home Assistant, non fermarti qui! Hai tanti articoli che magari ti sarai perso eccone alcuni:
🔗 Android Auto 16.7: il clima dallo schermo è Incredibile
Hai dubbi su qualsiasi cosa in ambito domotico o vuoi condividere le tue dashboard futuristiche? Non restare isolato! Unisciti a centinaia di appassionati di domotica e tecnologia nel nostro gruppo ufficiale.
👥 Segui il gruppo Facebook
Ti aspettiamo per confrontarci, scambiare consigli e restare sempre aggiornati sulle ultime novità del mondo Smart Home!