📱 1. Introdução

Bem-vindo! O GPSBRA é um aplicativo de navegação GPS offline, desenvolvido especialmente para dispositivos móveis e uso em midias automotivas. O GPSBRA usa mapas detalhados do Brasil com navegação completa, sem necessidade de conexão com a internet.

⬇️ 2. Instalação

📱 Android

• 1 Acesse a página do GPSBRA (https://gpsbra.org)
• 2 Toque no link da Google Play e instale o aplicativo pela loja. Instalado assim, o GPSBRA recebe as atualizações automaticamente

📦 Instalação pelo APK (se a Play Store não funcionar)

• 1 Na página do GPSBRA, toque no link "APK GPSBRA"
• 2 Aguarde o download do arquivo APK
• 3 Abra o arquivo baixado e autorize a instalação de fontes desconhecidas, se solicitado
• 4 Siga as instruções na tela para concluir a instalação

🍎 iOS (iPhone/iPad)

O GPSBRA para iOS está disponível na loja de aplicativos da Apple.

• 1 Na loja da Apple procure por gpsbra
• 2 Clique na instalação

🚀 3. Primeiros Passos

Primeira Execução

Ao abrir o GPSBRA pela primeira vez, você verá:

• 1 Download de mapas: O aplicativo perceberá que os mapas ainda não foram instalados e exibirá a página de Configurações > Download de Mapas. O download requer conexão com a internet.

  Atenção. Baixe somente a região onde mora. O GPSBRA irá avisar quando será necessário baixar outros mapas.

• 2 Tela principal: Após o download, retorne à tela principal e você verá o mapa centrado na sua localização.

Interface Principal

A tela principal do GPSBRA mostra o mapa e sua localização em tempo real e os seguintes botões:

• Config.: Acesso às configurações e às funcionalidades adicionais
• Rota: Para procurar endereços e pontos de interesse e usá-los como destino final de uma rota
• Salvar: Aparece sempre que há um destino definido (inclusive durante a navegação) e guarda esse destino em Casa 1, Casa 2 ou Trabalho/Estudo
• Parar: Aparece durante a navegação e encerra a rota em andamento
• Combust.: Busca o posto mais próximo (até 50 km) e mostra a opção IR para criar a rota. Se o veículo estiver configurado como Elétrico, a busca é feita em carregadores
• Botão de localização: Centraliza o mapa na sua posição atual
• Registrar Percurso / Registrar Posição: Botões opcionais, ativados em Configurações → Interface (veja a seção 7)

Painéis de Informação

• Velocidade: Sua velocidade atual em km/h
• Altitude, direção e zoom: Mostrados no painel de informações do mapa
• Rodapé: Pode mostrar as coordenadas do GPS ou o nome da próxima via à frente (acima de 10 km/h). Escolha em Configurações → Visualização → Rodapé
• Aviso de mapa faltando: Um banner aparece quando não há mapa baixado para o local onde você está (veja a seção 8)

🗺️ 4. Navegação e Uso do Mapa

Controles Básicos

• Arrastar: Toque e arraste para mover o mapa
• Zoom/Pinça: Use dois dedos para zoom. O aplicativo poderá demorar um pouco para atualizar a tela, pois precisará ler novos mapas
• Rotação: Arraste com dois dedos em movimento circular

Orientação do Mapa

Em Configurações → Navegação → Orientação do Mapa escolha:

• Norte: o norte fica sempre para cima
• Direção: o mapa gira para que a via percorrida fique sempre para cima, na direção do movimento. A rotação é suavizada para evitar tremores em curvas seguidas

Durante a navegação, o cursor de posição fica no terço inferior da tela, deixando mais espaço para ver o caminho à frente. O traçado da rota começa sempre exatamente na sua posição, sem sobrar trecho atrás do cursor.

Visualização de Informações

Toque em qualquer elemento do mapa para ver informações detalhadas:

• Ruas: exibe Nome e tipo
• POIs: Nome, categoria e coordenadas
• Áreas: Bairros, parques e regiões

O que Exibir no Mapa

Em Configurações → Visualização você liga ou desliga:

• Ícones de Pontos: ícones de POIs (postos, restaurantes etc.)
• Títulos de Pontos: nomes dos POIs junto aos ícones
• Nomes de Vias: nomes de ruas e avenidas

Modo Noturno

Quando conectado ao CarPlay ou Android Auto, o mapa pode acompanhar o sensor de dia/noite do carro. O modo noturno escurece o mapa mantendo o contraste entre rodovias, avenidas e estradas de terra. Em Configurações → Visualização → Modo Noturno Automático:

• Multimídia: a tela do CarPlay/Android Auto acompanha o sensor do carro
• Celular: a tela do próprio celular também acompanha o sensor, enquanto conectado (ligado por padrão)

Níveis de Zoom

O GPSBRA ajusta automaticamente o nível de detalhes baseado no zoom:

• Zoom baixo: Visão de estados e cidades principais
• Zoom médio: Bairros e ruas principais
• Zoom alto: Ruas detalhadas e POIs

🛰️ 5. Roteamento Offline e Online

As opções ficam em Configurações → Navegação → Roteamento.

Roteamento Offline (padrão)

O GPSBRA calcula as rotas com os mapas Tracksource baixados em seu dispositivo. Esse é o modo padrão e é usado sempre que os mapas da região estão instalados.

• Vantagens: Rápido, não consome dados, funciona em qualquer lugar e sem internet

Roteamento Online

O app calcula a rota por um serviço online quando há conexão com a internet e a opção Forçar roteamento offline está desligada em Configurações → Roteamento. Essa opção só pode ser desligada depois de cadastrar a chave gratuita (veja abaixo). Se a internet falhar durante o cálculo, o app volta automaticamente para o roteamento offline.

Preferências de Rota (Evitar)

• Pedágios
• Balsas
• Estradas de Terra
• Retornos (U-turn)

🛣️ 6. Criação e Uso de Rotas

Como Criar uma Rota

• 1 Toque no botão "Rota" na tela principal
• 2 Atenção: O ponto de partida usa sempre sua localização atual. Aguarde o sinal do GPS antes de calcular a rota
• 3 Escolha o tipo de rota a ser calculada:
         - Menor distância
         - Menor tempo
         - Rota direta (voo)
         - Trilhas e 4x4 (certifique-se de que seu veículo é adequado)
• 4 Defina o destino de uma destas formas:
         - Um dos atalhos rápidos: Última busca, Casa 1, Casa 2 ou Trabalho
         - Selecionar por Tipo de Ponto (veja abaixo)
         - Campo "Ou digite o destino", onde você pode buscar por:
                · Coordenadas (latitude, longitude)
                · Endereços (rua, número, cidade). O número é opcional: "Rua X, Município" também funciona. Se deixar a cidade em branco, o aplicativo busca perto da posição atual. Quando existem ruas com o mesmo nome em cidades diferentes, cada resultado mostra a cidade (ex.: "Rua X, Tavira")
                · NOME de Pontos de interesse (POIs), pontos importados de arquivos .gpx ou pontos do Google Maps (isso é automático)
• 5 Com o destino escolhido, você pode tocar em "Salvar" (guardar como favorito), "Mostrar no Mapa" ou "Criar Rota"
• 6 Depois de calculada, a rota aparece no mapa com os botões "Rotear" (inicia a navegação), "Mostrar" (exibe a rota inteira) e "Limpar" (descarta a rota). Para interromper a navegação, toque em "Parar"

Selecionar por Tipo de Ponto

Mostra os pontos de interesse próximos de uma categoria, que podem ser ordenados por distância ou de A a Z:

• Hospitais, Farmácias, Alimentação, Hospedagem, Postos (ou Carregadores, para veículo elétrico), Serviços, Bancos, Transporte, Estacionamento e Compras
• Outros: Academia, Camping, Pesca/Rio, Convenções, Correios, Escola, Estádio, Polícia, Teatro e mais

Favoritos

O aplicativo permite que você guarde três endereços de sua preferência e salva o último destino pesquisado:

• Casa 1
• Casa 2
• Trabalho/Estudo
• Última busca

Para salvar um favorito, toque em "Salvar" na tela de Rota ou no botão Salvar da tela principal, que continua disponível durante a navegação.

Durante a Navegação

Enquanto navega, você terá as seguintes informações:

• Instruções de voz: Avisos de curvas, manobras e saídas de rotatória. Liga/desliga em Configurações → Navegação → Navegação por Voz. Se estiver ouvindo música em outro app, ela volta a tocar sozinha depois do aviso
• Distância restante: Até o próximo ponto e até o destino
• Tempo estimado: Previsão de chegada
• Velocidade atual: Sua velocidade em tempo real
• Próximas manobras: Visualização das próximas ações
• Recálculo: A rota será recalculada automaticamente caso voce se afaste da rota em uso

🚨 7. Alarmes, Percursos e Pontos

Alarmes

Em Configurações → Navegação → Configurar Alarmes ative os avisos que deseja receber ao se aproximar de determinados pontos:

• Radar: o aviso informa também a velocidade do radar
• Polícia
• Lombada
• Pedágio
• Perigo / Área de Risco
• Marco da Estrada Real e Rota Imperial

O aviso é falado e exibido na tela com a distância até o ponto (ex.: "Atenção: Polícia a 500m"). Os alarmes só disparam com o veículo em movimento, acima de 15 km/h. Para radares, o aviso não é dado se você estiver abaixo de 90% do limite de velocidade.

Registrar Percurso

Ative o botão em Configurações → Interface → Botão Registrar Percurso. Na tela principal, toque no botão para iniciar a gravação e toque novamente para finalizar. O percurso é salvo como arquivo .gpx na pasta gpx do aplicativo.

Registrar Posição

Ative o botão em Configurações → Interface → Botão Registrar Posição. Ao tocar nele, o app registra a posição atual do GPS: dê um nome ao ponto e toque em "Salvar".

🗺️ 8. Gerenciar Mapas e Avisos de Cobertura

Gerenciar Mapas

Em Configurações → Importação e Exportação de Arquivos → Gerenciar Mapas você abre a tela Selecionar Regiões, onde pode:

• Baixar uma região
• Remover uma região já instalada
• Atualizar Mapas: baixa novamente todas as regiões instaladas

Ao terminar um download, o app confere se todos os arquivos de mapa da região foram baixados e extraídos corretamente. O mapa novo aparece na tela assim que você volta ao mapa.

Avisos de Cobertura

• Mapa faltando: se você estiver num local sem mapa baixado, um banner informa o nome da região necessária e oferece o botão "Baixar"
• Aviso antecipado (50 km): ao se aproximar de uma região ainda não baixada, o app avisa a distância até ela antes de você perder a cobertura, com atalho para o download. O aviso aparece uma única vez por aproximação
• Esses avisos também aparecem no CarPlay e no Android Auto

🚗 9. CarPlay e Android Auto

Com o celular conectado ao carro, o GPSBRA aparece na central multimídia. A rota calculada no celular é exibida na tela do carro, e vice-versa.

Na Tela do Carro

• Painel de velocidade (no alto, à direita) e painel da próxima via (embaixo)
• Botões de zoom no mapa
• Cursor de navegação no terço inferior da tela
• Pontos de interesse, títulos de pontos e nomes de vias, conforme as opções de Configurações → Visualização
• Modo noturno automático, seguindo o sensor de dia/noite do carro
• Avisos de mapa faltando e de região próxima não baixada

Exclusivo do CarPlay (iOS 26 ou superior)

• Arrastar e zoom com gesto de pinça (dois dedos)
• Rotação manual do mapa com dois dedos (veículo parado ou em baixa velocidade)

Exclusivo do Android Auto

• Comando de voz "Navegar para X" pelo Assistente Google inicia a rota no GPSBRA

⚙️ 10. Resumo das Configurações

Toque em Config. na tela principal. As opções estão organizadas assim:

A versão instalada do aplicativo aparece no final da tela de Configurações.

🎨 11. Personalização de Estilos

O GPSBRA permite personalizar completamente a aparência do mapa. Você pode escolher as cores de ruas e de polígonos, os ícones dos Pontos de Interesse (POIs) e muito mais.

Tipos de Elementos Personalizáveis

Arquivos de Estilo

Os estilos são armazenados em arquivos JSON na pasta /GPSBRA/styles na memória do dispositivo:

• styles_points.json - Configurações de pontos de interesse
• styles_lines.json - Configurações de ruas e estradas
• styles_polygons.json - Configurações de áreas e polígonos

✏️ 12. Editor de Estilos

O Editor de Estilos é uma ferramenta web que permite editar as configurações visuais do mapa de forma intuitiva, sem necessidade de editar arquivos JSON manualmente.

Requisitos

Como Usar o Editor

• 1 Preparar os arquivos:
  • Crie uma pasta no seu computador (ex: "GPSBRA_Estilos")
  • Copie as pastas /styles e /icons do seu celular para esta pasta
  • Você pode usar cabo USB, Bluetooth ou serviços de nuvem para transferir
  • É possivel editar os arquivos diretamente no dispositivo se ele estiver conectado ao computador, mas desaconselhamos essa prática.
• 2 Abrir o Editor:
  • Acesse editor.html no Chrome ou no Edge
  • Clique em "Abrir Pasta Local"
  • Selecione a pasta que você criou
  • Autorize o acesso, quando solicitado pelo navegador
• 3 Editar estilos:
  • Selecione o arquivo que deseja editar (pontos, linhas ou polígonos)
  • Uma tabela será exibida com todos os elementos
  • Edite as propriedades desejadas (cores, labels, visibilidade etc.)
• 4 Salvar alterações:
  • Clique em "Salvar Alterações"
  • As mudanças serão gravadas diretamente nos arquivos
  • Você pode clicar em "Recarregar" para desfazer mudanças não salvas
• 5 Transferir de volta:
  • Copie as pastas editadas de volta para o seu celular
  • Substitua as pastas antigas pelas novas
  • Reinicie o GPSBRA para ver as mudanças

Funcionalidades do Editor

• Edição de cores: Seletor de cores visual
• Edição de labels: Renomeie elementos para melhor identificação
• Controle de visibilidade: Mostre ou oculte elementos específicos
• Edição de bordas: Ative/desative e configure cores de bordas
• Configuração de linhas: Ajuste largura e estilo (sólida/tracejada)
• Editor de ícones integrado: Edite ícones pixel por pixel (veja próxima seção)

🎯 13. Editor de Ícones

O Editor de Ícones permite criar e modificar os ícones dos pontos de interesse (POIs) diretamente no navegador.

Acessando o Editor de Ícones

• Abra o Editor de Estilos
• Selecione o arquivo styles_points.json
• Na coluna "Ações", clique no botão "Editar" ao lado do ícone que deseja modificar
• Uma janela modal será aberta com o editor de pixels

Ferramentas Disponíveis

• Lápis: Desenhe pixels com a cor selecionada
• Borracha: Apague pixels
• Seletor de cor: Escolha qualquer cor
• Limpar: Apaga a tela de edição
• Preview: Visualização em tempo real do ícone

Como Editar um Ícone

• 1 Selecione a ferramenta (Lápis ou Borracha)
• 2 Escolha uma cor no seletor de cores
• 3 Clique e arraste na tela para desenhar
• 4 Observe o preview em tempo real
• 5 Clique em "Salvar Ícone" quando terminar ou em "Cancelar", para descartar as mudanças

Especificações Técnicas

• Tamanho: 48x48 pixels
• Formato: PNG com transparência
• Zoom do editor: 10x para facilitar a edição pixel por pixel

🔄 14. Importação e Exportação de Arquivos

O GPSBRA permite importar arquivos diretamente de qualquer pasta do dispositivo (incluindo iCloud, Google Drive ou outras origens acessíveis pelo seletor de arquivos do sistema) e exportar/compartilhar os arquivos do app com outras pessoas ou aplicativos. Esses recursos ficam em Configurações → Importação e Exportação de Arquivos.

Importando Arquivos

Existem três tipos de importação disponíveis. Em todos os casos, o app abre o seletor de arquivos nativo do sistema (Android/iOS), permite selecionar um ou vários arquivos de uma vez, e copia cada um para a pasta correta dentro do app.

Como Importar

• 1 Abra Configurações → Importação e Exportação de Arquivos
• 2 Toque em "Importar mapas", "Importar pontos" ou "Importar styles", conforme o tipo de arquivo desejado
• 3 Confirme na janela de aviso tocando em "Selecionar arquivos" (ou toque em "Cancelar" para desistir)
• 4 No seletor de arquivos do sistema, escolha um ou mais arquivos do tipo correspondente
• 5 Aguarde a cópia terminar. O app mostra quantos arquivos foram importados, quantos já existiam e quantos falharam

Exportando Arquivos

Ao tocar em "Exportar arquivos", escolha primeiro a categoria desejada: Mapas (.img), Pontos (.gpx), Styles (.json) ou Logs de diagnóstico (.log). Em seguida, selecione quais arquivos dessa categoria deseja enviar e confirme. O app abre a janela de compartilhamento nativa do sistema, de onde é possível enviar os arquivos por e-mail, iCloud, Google Drive, WhatsApp ou qualquer outro app instalado no dispositivo. A tela de seleção também mostra o e-mail do suporte.

Para os Logs de diagnóstico, além de "Compartilhar" há a opção "Copiar texto", que copia o conteúdo do log para colar numa mensagem.

💡 15. Dicas e Truques

Melhore a Precisão do GPS

• Certifique-se de estar em área aberta (evite túneis e prédios altos)
• Ative o "Modo de alta precisão" nas configurações de localização do Android/iOS
• Aguarde alguns segundos após abrir o app para o GPS se estabilizar
• Mantenha o aplicativo atualizado

Atalhos Úteis

• Toque duplo com dois dedos: Zoom out rápido
• Botão Combust.: Rota para o posto (ou carregador) mais próximo com dois toques
• Clique na tela: Abre menu de informações na parte inferior, mostrando detalhes do local, como nome, coordenadas e código Garmin. Cria opção de navegação para o ponto selecionado

🔧 16. Solução de Problemas

O mapa não carrega ou aparece em branco

• Verifique se os mapas da região foram baixados (Configurações → Gerenciar Mapas) ou se há um banner de mapa faltando
• Reinicie o aplicativo
• Limpe o cache do aplicativo nas configurações do sistema
• Reinstale o aplicativo se o problema persistir

GPS não encontra minha localização

• Verifique se as permissões de localização estão ativadas
• Certifique-se de que o GPS do dispositivo está ligado
• Saia de ambientes fechados ou com muitos obstáculos
• Aguarde alguns minutos para o GPS se estabilizar
• Reinicie o dispositivo

Rotas não são calculadas

• Verifique se o destino está dentro da área coberta pelos mapas instalados (se não estiver, use o botão "BAIXAR MAPA")
• Aguarde o sinal do GPS: a rota só é calculada a partir da sua posição atual
• Se a rota é calculada online e ignora as opções de Evitar, confira a chave em Configurações → Roteamento
• Verifique se há atualizações disponíveis

Aplicativo está lento ou travando

• Feche outros aplicativos em execução
• Reinicie o dispositivo

Estilos personalizados não aparecem

• Confirme que a sintaxe JSON está correta (use sempre um validador online)
• Utilize os recursos de importação e exportação para garantir a validação e instalação correta

💬 17. Suporte e Comunidade

Grupo Tracksource no WhatsApp

Participe da comunidade Tracksource no WhatsApp para:

• MELHORAR OS MAPAS enviando informações e/ou se tornando desenvolvedor do mapa da sua cidade e outras.
• Tirar dúvidas
• Compartilhar estilos e ícones personalizados
• Reportar bugs e problemas
• Sugerir novas funcionalidades
• Receber notificações sobre atualizações
• Trocar experiências com outros usuários

Reportando Problemas

Ao reportar um problema, inclua:

• Informações do sistema operacional
• Versão do GPSBRA instalada (aparece no final da tela de Configurações)
• Descrição detalhada do problema
• O arquivo de log (Configurações → Exportar arquivos → Logs de diagnóstico). O log já registra a versão do app
• Screenshots ou vídeos, se possível
• Se o problema for uma Rota, inclua as coordenadas ou referências do início e destino

Contribuindo com o Projeto

Você pode ajudar o GPSBRA a melhorar:

• Testando versões Beta e reportando bugs
• Criando e compartilhando temas visuais
• Sugerindo melhorias na interface
• Ajudando outros usuários no grupo
• Divulgando o aplicativo para amigos

Atualizações

O GPSBRA recebe atualizações regulares com:

• Correções de bugs ( e mais bugs 😊)
• Novos recursos
• Melhorias de performance
• Otimizações de interface