Introduzione
L’aggiornamento Carburanti Italia 2.0 è finalmente pronto e, se c’è una cosa che ho imparato gestendo Domusteck, è che la community è la risorsa più preziosa per far evolvere questi strumenti. Ricevo ogni giorno tantissime e-mail con suggerimenti, casi d’uso particolari e segnalazioni preziose; è proprio grazie a questo scambio continuo che oggi sono felice di presentarti una release davvero ‘corposa’.
Il lavoro è stato duro, ma l’integrazione e la relativa card sono state praticamente riviste per adattarsi meglio alle esigenze specifiche di chi vive la domotica quotidianamente: chi ha più auto in famiglia, chi risiede in zone con pochi distributori o, semplicemente, chi desidera non impazzire cercando l’indirizzo esatto di una stazione di servizio.
Come ogni progetto software in continua evoluzione, anche questa integrazione e la relativa card non sono prive di errori. Ci metto il massimo impegno per renderle perfette, ma resto a disposizione attraverso i canali ufficiali per segnalazioni o bug report.
Le novità dell’aggiornamento
Dietro questo rilascio c’è una profonda revisione tecnica. Ecco cosa è stato implementato per rendere il sistema più intelligente e meno “statico”:
Un cuore più veloce (Backend):
- Coordinate GPS reali: Sono state integrate le coordinate geografiche recuperate direttamente dal database del Ministero delle Imprese e del Made in Italy (MIMIT). Questo è il pezzo del puzzle che mancava per attivare la navigazione assistita.
- Aggiornamenti ogni ora: Sono stati ridotti drasticamente i tempi di attesa. Ora i sensori effettuano un refresh ogni ora, garantendo dati molto più vicini alla realtà dell’osservaprezzi del MISE.
- Raggio d’azione aumentato a 15km: Molti lettori mi hanno segnalato che 5 km erano limitanti, specialmente fuori dai grandi centri abitati. È stato quindi triplicato il raggio di ricerca predefinito.
- Nuovo schema dei nomi: È stata cambiata la logica di assegnazione dei nomi alle entità (naming convention). Ora ogni sensore specifica meglio la città e il tipo di carburante (es.
sensor.carburanti_foggia_metano_top_20), permettendoti di monitorare diversi tipi di alimentazione per la stessa città senza conflitti.
Una veste grafica interattiva (Fuel Card 0.9)
- Il tasto “Apri in Maps”: È la novità più attesa. Cliccando su una stazione, la card mostra un popup con l’indirizzo completo e un pulsante blu per avviare istantaneamente la navigazione sul tuo smartphone.
- Timestamp di freschezza: È stato aggiunto un attributo chiamato “ultimo aggiornamento” che indica la data e l’ora esatta del recupero dati. Questa informazione apparirà automaticamente in basso alla card.
- Layout Adattivo: La card ora è più intelligente. Se nella tua città sono presenti meno di 20 stazioni, il sistema inserirà solo le celle adatte al numero di stazioni che hanno effettivamente pubblicato i prezzi, evitando spazi vuoti antiestetici.
Guida all’installazione: come procedere correttamente
Poiché sono state apportate modifiche strutturali alla logica dei dati, sconsiglio di procedere con un semplice aggiornamento tramite notifica standard di Home Assistant. Per evitare errori, ti suggerisco di seguire questi passaggi:
Aggiornare l’Integrazione
Il mio consiglio spassionato è di rimuovere l’integrazione esistente e reinstallarla da zero. È la procedura più pulita.
- Trovi la guida aggiornata qui: Integrazione Ufficiale Carburanti Italia
- Segui la configurazione guidata tramite questo link:
- Se utilizzi HACS, vai nella sezione integrazioni, cerca “Carburanti Italia”, clicca sui tre puntini e seleziona “Scarica di nuovo”
Aggiornare la Custom Card
Per la parte grafica, il procedimento richiede un’azione manuale:
- Scarica il pacchetto
custom_card_v2.zipda questo [Link Google Drive]. - Scompatta il file zip e sovrascrivi il nuovo file
fuel-pro-v3.jsnel percorso di Home Assistant:config\www\gas-station-card - Pulizia della Cache (Fondamentale): Prima di inserire la nuova card, apri la tua dashboard su Google Chrome, elimina la vecchia card createa in precedenza, premi F12 sulla tua tastiera, recati nella sezione Applicazione, poi Spazio di archiviazione e premi il tasto “Cancella i dati dal sito”
- Ricarica la pagina premendo F5
- Effettua nuovamente l’accesso su Home Assistant con le tue credenziali
- Crea una nuova card manuale inserendo le seguenti righe:
type: custom:fuel-pro-v9 entity_top20: sensor.carburanti_nome-città_carburante_top_20
Esempio Pratico:
type: custom:fuel-pro-v9 entity_top20: sensor.carburanti_foggia_metano_top_20
Se la procedura è corretta, vedrai la card con i nomi delle stazioni e, cliccando sulle celle, apparirà l’indirizzo con il pulsante Apri in Maps, fondamentale per avere la navigazione immediata.
Dove trovare i file ufficiali
Ti ricordo che entrambi i file sono mantenuti e aggiornati sulle repository GitHub ufficiali di Domusteck:
Spero che questo aggiornamento ti renda la gestione del risparmio carburante più semplice ed efficace. Se incontri difficoltà, sai dove trovarmi!
Ti potrebbe interessare anche…
Se hai trovato utile questo aggiornamento per l’integrazione su Home Assistant, non fermarti qui ci sono tantissimi articoli e guide che ti aspettano!
Se non hai ancora istallato l’integrazione ufficiale e la custom card di Carburanti italia di Domusteck.it non rimandare affrettati a provarla:
👥 Segui il gruppo Facebook
Ti aspettiamo per confrontarci, scambiare consigli e restare sempre aggiornati sulle ultime novità del mondo Smart Home!