User it Getting Started

Primi passi

1. Installa

Google Play (Android)

Installa Sparkilo dal Google Play Store — la release pubblica di produzione.

Vieni dalla beta? Se ti sei iscritto al programma Open Testing (beta), Google Play continua a fornirti le build beta — la scheda mostra il nome dell'app con l'etichetta (beta) e la nota "Sei un beta tester". Per passare alla versione pubblica di produzione:

1. Apri la scheda su Play → sotto "Sei un beta tester", tocca Abbandona il programma.
2. Disinstalla la build beta, poi reinstallala da Play.

Vuoi le nuove funzionalità per primo? Rimani invece nel programma beta — le nuove build vengono distribuite al canale beta prima della produzione, così i tester ricevono ogni aggiornamento in anticipo.

F-Droid (Android, senza Google)

Sparkilo offre anche una build completamente senza GMS tramite il suo repository F-Droid dedicato (mappe OpenStreetMap, nessun servizio Google, nessun tracciamento). Nell'app F-Droid apri Impostazioni → Repository → + e aggiungi:

https://fdittgen-png.github.io/tankstellen/fdroid/repo

Poi cerca Sparkilo e installalo. (Se hai già installato la build di Play, disinstallala prima — la build F-Droid è firmata con una chiave diversa, quindi non può aggiornare la versione di Play.)

Altri modi per ottenerlo

• APK — scarica un APK di release da GitHub Releases.
• iPhone — la build per iOS è in beta TestFlight; richiedi un invito tramite GitHub Issues finché la scheda App Store non sarà online.

Nessun account, nessuna registrazione, nessuna email — l'app funziona pienamente nel momento in cui è installata.

Android minimo: 7.0 (API 24). Target: Android 15. iOS minimo: 15.5. Target: iOS 18.

2. Primo avvio — consenso GDPR

Al primissimo avvio l'app mostra una schermata di consenso GDPR dedicata, prima di qualsiasi altra UI. Spiega ogni permesso e procede solo quando tocchi Accetta.

• Permesso di posizione — necessario per trovare stazioni vicino a te. Scegli Mentre uso l'app. Puoi usare un codice postale invece, se preferisci non condividere mai il GPS.
• Notifiche — servono solo se vuoi gli avvisi di prezzo.
• Diagnostica — opzionale. Non viene inviato nulla se non tocchi esplicitamente Segnala problema.

Se neghi la posizione, puoi comunque cercare per codice postale o scegliendo una città sulla mappa.

3. Scegli paese e lingua

L'app rileva automaticamente entrambi dal locale di sistema. Se il rilevamento è sbagliato:

• Impostazioni → Paese — scegli tra i 17 paesi supportati.
• Impostazioni → Lingua — scegli tra 23 locali tradotti (bg, cs, da, de, el, en, es, et, fi, fr, hr, hu, it, lt, lv, nb, nl, pl, pt, ro, sk, sl, sv). L'intera UI si aggiorna immediatamente.

Cambiare paese svuota i dati delle stazioni in cache così ottieni risultati freschi per il nuovo paese.

4. Scegli un profilo (Base / Medio / Completo)

In Impostazioni → Profilo, scegli uno dei tre preset — raggruppano le funzionalità così non devi attivarle una per una:

• Base — ricerca prezzi, preferiti, avvisi, pianificazione percorso, ricarica EV. Nessun tracciamento consumi.
• Medio — Base più la scheda Consumi. Rifornimenti manuali e registrazione tragitti solo GPS (nessun hardware OBD2 richiesto). Il valore stimato di L/100 km converge dopo 3–8 rifornimenti tramite la matrice di calibrazione per veicolo.
• Completo — Medio più registrazione OBD2 dei tragitti (adattatore richiesto), registrazione automatica, gamification, fidelity card e gli eco-coach aptici/glide.

Puoi cambiare profilo in qualsiasi momento, oppure attivare singole funzionalità in Impostazioni → Funzionalità per un mix personalizzato.

5. API key (solo Germania)

La maggior parte dei paesi funziona subito. La Germania richiede una API key gratuita perché il servizio Tankerkoenig è rate-limited per utente.

• Apri creativecommons.tankerkoenig.de
• Clicca Get an API key e compila il (breve) modulo
• Copia la chiave — è simile a 00000000-0000-0000-0000-000000000002
• Nell'app: Impostazioni → API key → Germania → incolla → Salva

La chiave è salvata nel Keystore Android (crittografia hardware-backed) su Android, o nella Keychain iOS su iPhone, e non viene mai inviata altrove se non all'API Tankerkoenig.

6. La tua prima ricerca

Tocca il FAB centrale nella barra di navigazione in basso — è l'unico pulsante di ricerca in tutte le schede e sa cosa fare in base a dove ti trovi:

• Nella scheda Risultati di ricerca o Mappa → apre la scheda dei Criteri così puoi scegliere tipo di carburante, raggio e posizione di partenza.
• Dentro la scheda dei Criteri → un nuovo tocco avvia la ricerca.
• In qualsiasi altra scheda → salta al ramo Ricerca.

Ottieni un elenco di stazioni ordinato per prezzo (più economiche prima). Tocca una stazione per vedere dettagli, orari di apertura, metodi di pagamento accettati e ricevere indicazioni stradali. Vedi Trovare stazioni per il quadro completo.

7. Personalizza la schermata iniziale

Vai in Impostazioni → Schermata iniziale. Puoi scegliere cosa si apre quando tocchi l'icona dell'app:

• Le più economiche vicine (predefinito) — ricerca istantanea con i tuoi ultimi criteri
• Stazione più vicina — risultato singolo, percorso più rapido
• Preferiti — direttamente alle tue stazioni salvate
• Mappa — mappa completa con marker a cluster

8. Unità

In Impostazioni → Unità puoi scegliere come mostrare distanze, volumi e prezzi. I valori predefiniti dipendono dal paese: metrico (km, L, €/L) nell'Europa continentale; imperiale-style (mi per i cartelli stradali nel Regno Unito, c/L per AU, ecc.) dove appropriato.

---

Prossimo: Trovare stazioni →