User pt Getting Started

Começar

1. Instalar

Google Play (Android)

Instala a Sparkilo a partir da Google Play Store — a versão pública de produção.

Vens da beta? Se aderiste ao programa de Teste Aberto (beta), a Google Play continua a servir-te versões beta — a listagem mostra o nome da aplicação com a etiqueta (beta) e uma nota "És um beta tester". Para mudar para a versão pública de produção:

1. Abre a listagem na Play → em "És um beta tester", toca em Sair do programa.
2. Desinstala a versão beta e reinstala-a a partir da Play.

Queres as novidades primeiro? Mantém-te antes no programa beta — as novas versões são lançadas no canal beta antes da produção, por isso os testers recebem todas as atualizações mais cedo.

F-Droid (Android, sem Google)

A Sparkilo também disponibiliza uma versão totalmente sem GMS através do seu próprio repositório F-Droid (mapas OpenStreetMap, sem serviços Google, sem rastreio). Na aplicação F-Droid abre Definições → Repositórios → + e adiciona:

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

Depois pesquisa por Sparkilo e instala. (Se já tiveres a versão da Play instalada, desinstala-a primeiro — a versão do F-Droid está assinada com uma chave diferente, por isso não pode atualizar por cima da versão da Play.)

Outras formas de a obter

• APK — descarrega um APK de versão a partir das Releases no GitHub.
• iPhone — a versão para iOS está em beta no TestFlight; pede um convite em GitHub Issues até a listagem na App Store estar ativa.

Sem conta, sem registo, sem email — a aplicação funciona totalmente no momento em que é instalada.

Android mínimo: 7.0 (API 24). Alvo: Android 15. iOS mínimo: 15.5. Alvo: iOS 18.

2. Primeiro arranque — consentimento RGPD

No primeiro arranque a aplicação mostra um ecrã de consentimento RGPD dedicado antes de qualquer outra interface. Explica cada permissão e só prossegue quando tocares em Aceitar.

• Permissão de localização — necessária para encontrar estações perto de ti. Escolhe Enquanto a aplicação está em uso. Podes usar um código postal em vez disso se preferires nunca partilhar o GPS.
• Notificações — necessárias apenas se quiseres alertas de preço.
• Diagnósticos — opcional. Nada é enviado a menos que toques explicitamente em Reportar problema.

Se recusares a localização, podes ainda pesquisar por código postal ou escolhendo uma cidade no mapa.

3. Escolhe o teu país e idioma

A aplicação deteta ambos automaticamente a partir da localização do sistema. Se a deteção estiver errada:

• Definições → País — escolhe entre os 17 países suportados.
• Definições → Idioma — escolhe entre 23 localizações traduzidas (bg, cs, da, de, el, en, es, et, fi, fr, hr, hu, it, lt, lv, nb, nl, pl, pt, ro, sk, sl, sv). Toda a interface é atualizada imediatamente.

Mudar de país limpa os dados de estações em cache para teres resultados frescos para o novo país.

4. Escolhe um perfil (Básico / Médio / Completo)

Em Definições → Perfil, escolhe uma das três predefinições — agrupam funcionalidades para não teres de mexer em cada flag individualmente:

• Básico — pesquisa de preços, favoritos, alertas, planeamento de rota, carregamento EV. Sem rastreio de consumo.
• Médio — Básico mais o separador Consumo. Abastecimentos manuais e gravação de trajetos apenas com GPS (sem necessidade de hardware OBD2). A estimativa de L/100 km converge após 3–8 abastecimentos através da matriz de calibração por veículo.
• Completo — Médio mais gravação de trajetos por OBD2 (adaptador necessário), gravação automática, gamificação, cartões de fidelização e os eco-coaches háptico/glide.

Podes alternar perfis a qualquer momento ou mexer em funcionalidades individuais em Definições → Funcionalidades para uma mistura personalizada.

5. Chaves API (apenas Alemanha)

A maioria dos países funciona logo de início. A Alemanha requer uma chave API gratuita porque o serviço Tankerkoenig é limitado por utilizador.

• Abre creativecommons.tankerkoenig.de
• Clica em Get an API key e preenche o (curto) formulário
• Copia a chave — tem o formato 00000000-0000-0000-0000-000000000002
• Na aplicação: Definições → Chaves API → Alemanha → cola → Guardar

A chave é guardada no Android Keystore (encriptação suportada por hardware) em Android, ou no iOS Keychain no iPhone, e nunca é enviada para outro lado além da API Tankerkoenig.

6. A tua primeira pesquisa

Toca no FAB central na barra de navegação inferior — é o único botão de pesquisa em todos os separadores e sabe o que fazer com base em onde estás:

• No separador Resultados de pesquisa ou Mapa → abre a folha de Critérios para escolheres o tipo de combustível, raio e localização de origem.
• Dentro da folha de Critérios → um novo toque executa a pesquisa.
• Em qualquer outro separador → salta para o ramo Pesquisa.

Obténs uma lista de estações ordenadas por preço (mais baratas primeiro). Toca em qualquer estação para veres detalhes, horários, pagamentos aceites e obteres direções. Vê Encontrar estações para o panorama completo.

7. Personaliza o ecrã principal

Vai a Definições → Ecrã inicial. Podes escolher o que abre quando tocas no ícone da aplicação:

• Mais baratas perto (predefinição) — pesquisa imediata com os teus últimos critérios
• Estação mais próxima — resultado único, rota mais rápida
• Favoritos — direto às tuas estações guardadas
• Mapa — mapa completo com marcadores agrupados

8. Unidades

Em Definições → Unidades podes escolher como as distâncias, volumes e preços são mostrados. As predefinições variam por país: métrico (km, L, €/L) na Europa continental; tipo imperial (mi para distância no Reino Unido, c/L para AU, etc.) onde apropriado.

---

Seguinte: Encontrar estações →