User fr Troubleshooting FAQ

Dépannage et FAQ

« Aucun prix trouvé »

1. Vérifiez votre pays. Paramètres → Pays. Un profil enregistré pour l'Allemagne appellera l'API allemande ; si vous voyagez en France, changez de pays. L'application prend en charge 17 pays — assurez-vous d'avoir choisi le bon.
2. Vérifiez la connectivité. Hors ligne → pas de prix en direct. L'application bascule sur les derniers prix connus en cache (marqués obsolètes en rouge).
3. Panne d'API pays. Les API gouvernementales tombent parfois en panne. Réessayez dans quelques minutes. Consultez downdetector ou la page GitHub Issues.
4. Obsolescence du cache. Tirez pour rafraîchir ou touchez le bouton de rafraîchissement. L'application réessaie l'API.

Je ne trouve pas le bouton de recherche

L'application a un seul bouton Recherche central dans la barre de navigation du bas — c'est le seul déclencheur de recherche sur tous les onglets.

• Sur n'importe quel onglet → touchez-le pour basculer vers la branche Recherche.
• Sur les résultats de recherche ou la vue Carte → il ouvre la feuille Critères de recherche (carburant, rayon, source).
• À l'intérieur de la feuille Critères de recherche → un nouveau touché lance la recherche.

Les anciens boutons « Rechercher à proximité » et « Rechercher sur l'itinéraire » dans la liste de résultats ont été supprimés. Si le bouton semble grisé, c'est généralement parce que vous êtes en mode itinéraire sans destination renseignée.

Allemagne : « Clé API manquante » ou « Clé API invalide »

• Il vous faut une clé API gratuite depuis creativecommons.tankerkoenig.de.
• Le format de la clé est un UUID : 00000000-0000-0000-0000-000000000002.
• Collez-la dans Paramètres → Clés API → Allemagne.
• Si cela échoue encore, la clé a peut-être été limitée en débit par un usage intensif. Le service limite par clé — ne partagez pas vos clés publiquement.

La localisation est « inconnue » ou le GPS ne fixe jamais

• Ouvrez Paramètres Android → Localisation → activer. Accordez la permission Pendant l'utilisation à l'application.
• En intérieur ? Le GPS ne peut pas fixer en intérieur. Sortez ou utilisez la recherche par code postal à la place.
• Si l'application indique « Localisation approximative uniquement » — activez la localisation précise dans les paramètres système.

Le routage est lent ou échoue

• Le service de routage (OSRM) est public et parfois lent.
• Un itinéraire multi-pays peut diffuser des résultats partiels — le bandeau en haut vous indique quels pays répondent encore. Vous pouvez toucher un résultat dès qu'il apparaît.
• Réessayez. L'application met le tracé en cache, la seconde tentative est généralement instantanée.
• Si vous voyez systématiquement des dépassements de délai, ouvrez une issue avec le départ / la destination utilisés.

L'adaptateur OBD2 refuse de se connecter

Rien trouvé pendant le scan :

• La clé de contact doit être en position marche (accessoire ou contact, pas coupée). Moteur en marche, c'est très bien.
• La LED de l'adaptateur doit être allumée et fixe (bleue pour la plupart des modèles). Si elle clignote ou est éteinte, rebranchez-le.
• Le Bluetooth doit être activé sur le téléphone.
• Android 12+ : avez-vous accordé Bluetooth Scan et Bluetooth Connect ? Ouvrez Paramètres Android → Applications → Sparkilo → Autorisations.
• Android 11- : l'application a besoin de la permission Localisation pour énumérer les appareils BLE (une bizarrerie de l'OS — l'application n'enregistre jamais votre position pour cela).

Adaptateur visible mais la connexion échoue :

• Erreur « Sans réponse » — clone bon marché. Attendez 30 s, réessayez. Démarrez brièvement le moteur à fond.
• Erreur « Échec d'init du protocole » — puce ELM327 contrefaite. Essayez un autre modèle ; le vLinker FS est une option bon marché fiable.
• Erreur « Permission refusée » — accordez à nouveau dans les paramètres système ; certains Androids oublient les permissions Bluetooth après un redémarrage.

Se connecte mais l'odomètre lit 0 ou faux :

• Votre voiture n'expose peut-être pas le PID A6. L'application réessaie avec PID 31 et le Mode 22 constructeur (basé sur le VIN).
• Certaines voitures européennes anciennes (avant 2008) n'exposent pas du tout l'odomètre via OBD2. Vous devrez le saisir.

L'enregistrement automatique ne s'est pas déclenché

L'enregistrement automatique nécessite :

1. Adaptateur appairé à un véhicule — le premier appairage manuel crée l'association.
2. Enregistrement automatique activé dans Paramètres → OBD2 → Enregistrement automatique.
3. Bluetooth du téléphone activé, sans que l'optimisation système de batterie ne tue l'application.

iOS : le réveil en arrière-plan au niveau de l'OS nécessaire à « l'auto-connexion à la mise sous tension de l'adaptateur » est encore en chantier (#1542). Tant qu'il n'est pas livré, les utilisateurs iOS démarrent les trajets manuellement depuis l'onglet Trajets. Android gère aujourd'hui le flux entièrement automatique.

L'overlay PiP n'affiche pas la disposition prix

L'overlay d'approche ne se déclenche que lorsqu'un trajet est en cours d'enregistrement et que vous êtes à moins de profile.approachRadiusKm (1 km par défaut) d'une station. Si vous voulez vérifier que l'interface bascule correctement sans rouler, ouvrez Paramètres → Tableau de bord de confidentialité → Tester l'overlay d'approche — le bouton injecte un état synthétique « dans le rayon » pendant 30 s. Voir Consommation et OBD2 → Overlay d'approche pour la mise en place complète.

Les notifications ne se déclenchent pas pour les alertes de prix

• Les notifications système sont-elles activées ? Paramètres Android → Applications → Sparkilo → Notifications → Autoriser.
• Téléphone en mode ultra-économie d'énergie ? Les économiseurs agressifs d'Android tuent WorkManager. Mettez l'application en liste blanche : Paramètres → Batterie → non restreint.
• Le téléphone était hors ligne au moment du contrôle programmé. Le contrôle s'exécute à la fenêtre réseau suivante.
• Le prix n'est pas encore réellement passé sous le seuil.

Le widget d'écran d'accueil ne se met pas à jour

• Android limite les mises à jour de widget à une fois toutes les ~30 min minimum. C'est une politique système.
• Le widget utilise le même cache que l'application. Touchez l'icône de rafraîchissement sur le widget lui-même — il récupère les prix en arrière-plan sans ouvrir l'application.
• Toucher le widget ouvre la bonne station que l'application ait été tuée à froid ou soit déjà ouverte en mémoire ; si ce n'est pas le cas, ouvrez une issue avec votre modèle de téléphone et la version d'Android.

Les favoris et les alertes VE se chevauchent en paysage

Sur les téléphones en paysage et sur les tablettes (largeur ≥ 600 dp), l'écran Favoris affiche la liste des favoris et la liste des alertes côte à côte avec un séparateur vertical. Il n'y a pas de sélecteur d'onglets dans cette mise en page car les deux volets sont visibles en même temps. Repassez en portrait si vous préférez le sélecteur d'onglets.

« Enregistrer le journal d'erreurs » n'écrit pas le fichier

• Le bouton est dans Paramètres → Tableau de bord de confidentialité (il s'appelait autrefois « Copier » — il s'appelle « Enregistrer » à présent et écrit réellement dans Downloads).
• Vérifiez que vous avez accordé la permission d'accès aux fichiers lors du premier enregistrement.
• Si l'enregistrement échoue, l'application bascule sur la copie du journal dans le presse-papiers, pour que l'action ne reste jamais silencieusement sans effet.

L'application plante au lancement

• Vérifiez Paramètres → Vider le cache (via les paramètres système Android).
• Si le plantage persiste, ouvrez une issue avec : version Android, modèle de téléphone, version de l'app (depuis Paramètres → À propos), et le dernier rapport de plantage (l'application propose Enregistrer au lancement suivant — le fichier est dans Downloads).

Comment sauvegarder mes données ?

Paramètres → Données → Exporter toutes les données → fichier JSON écrit dans le dossier public Downloads. Stockez-le en lieu sûr. À la réinstallation, Importer dans le même écran.

Les utilisateurs de TankSync n'ont pas besoin de le faire — les données vivent sur votre instance Supabase. Notez que les trajets ne se synchronisent que si vous avez aussi activé Synchroniser les trajets dans les paramètres TankSync (c'est opt-in).

La carte affiche des tuiles grises / vides

• Cela arrive sporadiquement sur les connexions faibles.
• Balayez vers le bas pour rafraîchir la carte.
• Si cela persiste après fermeture et réouverture de l'application, les serveurs de tuiles OpenStreetMap limitent peut-être le débit ; réessayez quelques minutes plus tard.

Comment supprimer toutes mes données ?

Paramètres → Données → Réinitialiser l'application. Efface toutes les box Hive locales et vide le stockage sécurisé. Irréversible. Si vous utilisez TankSync, supprimez d'abord votre compte serveur : Paramètres → TankSync → Supprimer le compte, ou effacez uniquement les lignes de trajets avec Oublier tous les trajets synchronisés.

Puis-je utiliser l'application hors ligne ?

Partiellement. Les favoris fonctionnent hors ligne (derniers prix connus affichés). Les recherches nécessitent un appel réseau — vous ne pouvez pas découvrir de nouvelles stations sans cela. Les cartes mettent en cache les tuiles que vous avez récemment consultées, donc les zones que vous avez déjà visitées se chargent.

---

Plus d'aide

• Signaler un bug : github.com/fdittgen-png/tankstellen/issues — utilisez le template Bug Report. Joignez le journal d'erreurs enregistré depuis le Tableau de bord de confidentialité.
• Demander une fonctionnalité : template Feature Request, ou discutez d'abord dans les Discussions.
• Questions de confidentialité : voir PRIVACY.md.