Introduzione
Siamo entusiasti di presentarvi la Fuel Station Card, una soluzione grafica elegante, compatta e funzionale progettata specificamente per l’integrazione Carburanti Italia in Home Assistant. Se sei stanco delle visualizzazioni standard e cerchi qualcosa che renda la tua dashboard professionale e immediata, questa è la card che fa per voi.
✨ Caratteristiche principali
In questa prima versione, la card offre:
- Design Neon: Prezzi in verde neon per una lettura chiara anche su schermi piccoli.
- Layout a 5 colonne: Ottimizzato per mostrare fino a 20 stazioni in modo ordinato.
- Loghi Personalizzati: Caricamento locale dei loghi dei principali brand (Eni, Q8, IP, Tamoil, Esso, ecc.) per una velocità fulminea.
- Interattività Avanzata: Cliccando su ogni cella, un pratico avviso mostrerà istantaneamente l’indirizzo esatto della stazione scelta.
🛠️ Guida all’Installazione Passo-Passo
Per utilizzare la card, seguite questi semplici passaggi:
Scaricamento dei file
Potete scaricare il pacchetto completo (codice + loghi) direttamente dal seguente link : 👉 gas-station-card
Posizionamento dei file
Una volta scaricato il file gas-station-card.zip, estraetelo e copiate l’intera cartella gas-station-card nel percorso /config/www/ della vostra istanza di Home Assistant.
- Assicuratevi che il percorso finale sia:
/config/www/gas-station-card/fuel-pro-v3.js. - Controllate che all’interno di quella cartella sia presente anche la cartella
logos/con tutti i loghi delle stazioni di servizio:
Aggiunta della Risorsa
Recati nella pagina di Home Assistant dal browser (Google Chrome o Microsoft Edge) su Impostazioni > Plance > cliccate sui tre puntini in altro a destra e selezionate Risorse (abilitate la modalità avanzata se non la vedete) e clicca su “Aggiungi Risorsa“(in basso a destra) e compila i campi nel seguente modo:
- URL:
/local/gas-station-card/fuel-pro-v3.js - Tipo:
Modulo JavaScript
Configurazione della Card
Prima di passare alla configurazione vera e propria della card, consiglio di cancellare la cache del browser o ancor meglio i dati di navigazione degli ultimi 15 minuti, questa impostazione sarà sufficiente a evitare errori di visualizzazione.
Ad esempio su Google Chrome recati su Impostazioni-> Privacy e Sicurezza -> Elimina dati di navigazione -> seleziona Ultimi 15 min e clicca sul pulsante Elimina Dati
Posizionati ora nella Dashboard di Home Assistant, aggiungi una nuova card di tipo Manuale e incolla questo codice, sostituendo il nome del sensore con quello della vostra città:
type: custom:fuel-pro-v3 base_entity: sensor.nomecittà_stazione_
Il codice aggiungerà automaticamente i numeri delle stazioni presenti con la vostra integrazione da 1 a 20 al prefisso che hai indicato.
Se tutto è andato per il verso giusto la card dovrebbe presentarsi così:
⚠️ Nota sui prezzi “Unknown”:
Se dopo l’installazione vedi alcune celle con la scritta “Unknown”, non preoccuparti: è del tutto normale. Significa che nella zona scelta durante la configurazione dell’integrazione è stato trovato un numero limitato di stazioni (ad esempio 10). Poiché la card è predisposta per visualizzarne fino a 20 celle-stazioni di carburante, le posizioni dalla 11 in poi non riceveranno dati e mostreranno quel valore. In un prossimo aggiornamento lavoreremo per nascondere automaticamente le celle vuote!
Ricordo ai lettori che la card è anche disponibile sulla Repository ufficiale di Domusteck al seguente indirizzo:
https://github.com/domusteck/gas-station-card
🚀 Cosa riserva il futuro? (Prossimo Aggiornamento)
Il lavoro non finisce qui! Sto già sviluppando le prossime migliorie per l’integrazione carburanti italia dato il coinvolgimento di molte persone che mi hanno contatto anche in privato via email e includeranno:
- Estensione del raggio d’azione: Possibilità di visualizzare stazioni di servizio in un raggio più ampio rispetto alla città prescelta.
- Ottimizzazione del codice: Modifiche strutturali per garantire aggiornamenti dei prezzi ancora più rapidi e fluidi.
Ti potrebbe interessare anche…
Se hai trovato utile questa card per Home Assistant, non fermarti qui ci sono tantissimi articoli e guide che ti aspettano!
Se non hai ancora istallato l’integrazione ufficiale 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!