-
Notifications
You must be signed in to change notification settings - Fork 0
User de Getting Started
Installiere Sparkilo aus dem Google Play Store — die öffentliche Produktivversion.
Kommst du aus der Beta? Wenn du am Open-Testing-Programm (Beta) teilgenommen hast, liefert dir Google Play weiterhin Beta-Builds — im Eintrag erscheint der App-Name mit einem (beta)-Hinweis und dem Vermerk „Du bist Betatester". So wechselst du zur öffentlichen Produktivversion:
- Öffne den Play-Eintrag → tippe unter „Du bist Betatester" auf Programm verlassen.
- Deinstalliere den Beta-Build und installiere ihn anschließend neu aus dem Play Store.
Möchtest du neue Funktionen zuerst? Dann bleib stattdessen im Beta-Programm — neue Builds werden im Beta-Kanal vor der Produktivversion ausgerollt, sodass Tester jedes Update früher erhalten.
Sparkilo bietet über sein eigenes F-Droid-Repository außerdem einen vollständig GMS-freien Build (OpenStreetMap-Karten, keine Google-Dienste, kein Tracking). Öffne in der F-Droid-App Einstellungen → Repositories → + und füge hinzu:
https://fdittgen-png.github.io/tankstellen/fdroid/repo
Suche dann nach Sparkilo und installiere die App. (Falls du den Play-Build bereits installiert hast, deinstalliere ihn zuerst — der F-Droid-Build ist mit einem anderen Schlüssel signiert und kann daher nicht über die Play-Version aktualisieren.)
- APK — lade ein Release-APK von den GitHub Releases herunter.
- iPhone — der iOS-Build befindet sich in der TestFlight-Beta; fordere eine Einladung über GitHub Issues an, bis der App-Store-Eintrag live ist.
Kein Konto, keine Anmeldung, keine E-Mail — die App ist sofort nach der Installation voll nutzbar.
Mindest-Android: 7.0 (API 24). Zielversion: Android 15. Mindest-iOS: 15.5. Zielversion: iOS 18.
Beim allerersten Start zeigt die App vor jeder anderen Oberfläche einen eigenen DSGVO-Einwilligungsbildschirm an. Er erklärt jede Berechtigung und fährt erst fort, wenn du Annehmen antippst.
- Standortberechtigung — erforderlich, um Tankstellen in deiner Nähe zu finden. Wähle Bei Nutzung der App. Du kannst stattdessen eine Postleitzahl verwenden, falls du nie GPS teilen möchtest.
- Benachrichtigungen — nur nötig, wenn du Preisalarme möchtest.
- Diagnose — optional. Es wird nichts gesendet, sofern du nicht ausdrücklich Problem melden antippst.
Wenn du den Standort ablehnst, kannst du trotzdem nach Postleitzahl suchen oder eine Stadt auf der Karte auswählen.
Die App erkennt beides automatisch aus deiner Systemsprache. Wenn die Erkennung falsch ist:
- Einstellungen → Land — wähle aus den 17 unterstützten Ländern.
- Einstellungen → Sprache — wähle aus 23 übersetzten Sprachen (bg, cs, da, de, el, en, es, et, fi, fr, hr, hu, it, lt, lv, nb, nl, pl, pt, ro, sk, sl, sv). Die gesamte Oberfläche aktualisiert sich sofort.
Beim Wechsel des Landes werden zwischengespeicherte Tankstellendaten gelöscht, damit du frische Ergebnisse für das neue Land erhältst.
Die App kann so einfach oder so tief sein, wie du möchtest. Wähle unter Einstellungen → Nutzungsmodus eines von drei Presets — sie bündeln Funktionen, damit du nicht jeden Schalter einzeln umlegen musst:
- Basis — das Wesentliche: günstigen Sprit und EV-Laden finden, Favoriten, Preisalarme, Routenplanung. Die untere Leiste ist nur Favoriten · Karte · Suche. Wähle das, wenn du einfach nur günstiger tanken willst.
- Mittel — alles aus Basis, plus einen Sprit-Tab, um Tankvorgänge zu erfassen und deinen echten Verbrauch und deine Kosten zu verfolgen. Fahrten lassen sich allein mit dem GPS des Telefons aufzeichnen — keine Zusatzhardware. Die untere Leiste ergänzt Sprit.
- Voll — alles aus Mittel, plus ein Fahrten-Fahrtenbuch mit freihändiger Aufzeichnung und Eco-Coaching sowie Unterstützung für einen einsteckbaren OBD2-Adapter für die genauesten Werte. Die untere Leiste ergänzt Fahrten.
Du kannst jederzeit wechseln, und Benutzerdefiniert lässt dich einzelne Funktionen unter Einstellungen → Funktionen für deine eigene Mischung umlegen.
Die meisten Länder funktionieren sofort beim Öffnen der App. Deutschland ist die einzige Ausnahme: Sein offizieller Preisdienst verlangt von jedem Nutzer einen kostenlosen Key.
- Öffne creativecommons.tankerkoenig.de
- Klicke auf API-Key beantragen und fülle das (kurze) Formular aus
- Kopiere den Key — er sieht aus wie
00000000-0000-0000-0000-000000000002 - In der App: Einstellungen → API-Keys → Deutschland → einfügen → Speichern
Der Key wird unter Android im Android Keystore (hardwaregestützte Verschlüsselung) bzw. unter iPhone in der iOS-Keychain abgelegt und niemals irgendwohin gesendet außer an die Tankerkoenig-API.
Die Leiste am unteren Bildschirmrand hat fünf Plätze. Die große runde Such-Schaltfläche sitzt in der Mitte, leicht erhöht in einer Kerbe, damit sie immer am leichtesten zu treffen ist:
- ⭐ Favoriten — deine gespeicherten Tankstellen und Preisalarme
- 🗺️ Karte — jede Tankstelle in der Nähe als farbiger Pin
- 🔍 Suche (die zentrale Schaltfläche) — finde günstigen Sprit oder Strom in deiner Nähe oder entlang einer Route
- ⛽ Sprit — dein Tank, dein Verbrauch und deine Tankvorgänge (erscheint bei Mittel / Voll)
- 🛣️ Fahrten — dein Fahrtenbuch und das Eco-Coaching (erscheint bei Voll)
Einstellungen sind kein Tab — tippe auf die Zahnrad-/Profil-Schaltfläche oben rechts auf jedem Bildschirm.
Auf einem Tablet oder einem quer gehaltenen Telefon teilt sich die App in zwei Spalten, sodass du Liste und Karte (oder Details) gleichzeitig siehst.
Tippe auf die große Such-Schaltfläche in der Mitte der unteren Leiste. Sie weiß, was du brauchst:
- Von den meisten Bildschirmen öffnet sie ein kurzes Kriterien-Blatt, in dem du Kraftstoffart, Suchradius und in der Nähe vs. entlang einer Route wählst.
- Tippe in diesem Blatt erneut auf Suche, um sie zu starten.
Du erhältst eine Liste mit der günstigsten Tankstelle zuerst. Tippe auf eine Tankstelle, um Preise, Öffnungszeiten, Ausstattung und eine Route zu sehen. Siehe Tankstellen finden für die ganze Tour.
Gehe zu Einstellungen → Startbildschirm. Du kannst festlegen, was beim Tippen auf das App-Icon geöffnet wird:
- Günstigste in der Nähe (Standard) — sofortige Suche mit deinen letzten Kriterien
- Nächstgelegene Tankstelle — einzelnes Ergebnis, schnellste Route
- Favoriten — direkt zu deinen gespeicherten Tankstellen
- Karte — Vollkarte mit Cluster-Markierungen
Unter Einstellungen → Einheiten kannst du wählen, wie Entfernungen, Volumen und Preise angezeigt werden. Standard ist je Land: metrisch (km, L, €/L) in Kontinentaleuropa; imperial-ähnlich (mi für Entfernungsschilder im UK, c/L für AU usw.) wo angebracht.
Weiter: Tankstellen finden →
👤 User Guide
🛠️ Developer Guide
Architecture
Code patterns
Quality
Deep dives
Reference
Workflow