📱 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 "APK GPSBRA"
• 3 Aguarde o download do arquivo APK
• 4 Abra o arquivo baixado e autorize a instalação de fontes desconhecidas, se solicitado
• 5 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:

• Configurações: 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
• Combustível: Cria uma rota para o posto de combustível mais próximo
• Botão de localização: Centraliza o mapa na sua posição atual

🗺️ 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
• Inclinação: Arraste dois dedos para cima/baixo (visão 3D)

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

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

O GPSBRA oferece duas opções de roteamento para melhor atender às suas necessidades de navegação:

Roteamento Offline

Utiliza os mapas Tracksource baixados em seu dispositivo. Esta opção é ideal quando você não tem conexão com a internet ou deseja economizar dados móveis.

• Vantagens: Rápido, não consome dados, funciona em qualquer lugar e sem internet
• Como usar: Selecione Forçar roteamento offline em Configurações > Roteamento. O roteamento offline é ativado automaticamente quando não houver internet ativa.

Roteamento Online (ORS)

Conecta aos servidores de roteamento ORS (Open Route Service) pela internet, oferecendo rotas com dados mais atuais e em tempo real.

• Vantagens: Dados mais atualizados em cidades médias e grandes
• Requisito: Conexão ativa com a internet
• Obtenção de Key: Para usar o roteamento online sem limitações, você precisa obter uma chave de acesso exclusiva e gratuita. O uso sem chave é possível mas limitado pelo servidor ORS.

  Acesse o ORS para configurar sua key

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

Como Criar uma Rota

• 1 Toque no botão de "Rotas" no menu principal
• 2 Atenção: O ponto de partida usa sempre sua localização atual
• 3 Escolha o tipo de rota a ser calculada:
         - Rota de menor distância
         - Rota de menor tempo
         - Rota Direta (simulação de voo)
         - Rota por Trilhas e 4x4 (certifique-se que seu veículo é adequado)
• 4 Defina o destino através da busca ou tocando no mapa. Voce pode buscar por:
         - Coordenadas (latitude, longitude)
         - Endereços (rua, número, cidade). Se deixar a cidade em branco, o aplicativo busca na posição atual.
         - NOME de Pontos de interesse (POIs) ou Pontos do Google Maps (isso é automático).
• 4 Nas configurações você pode escolher evitar pedágios, balsas e estradas de terra
• 5 Toque em "Calcular Rota"
• 6 Toque em "Iniciar". Para interromper a navegação, toque em "Sair"

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
• Último destino pesquisado

Durante a Navegação

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

• Instruções de voz: Avisos de curvas e manobras
• 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. 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:

• points.json - Configurações de pontos de interesse
• lines.json - Configurações de ruas e estradas
• polygons.json - Configurações de áreas e polígonos

✏️ 8. 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)

🎯 9. 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 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

🔄 10. 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.

💡 11. 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
• Toque longo: Adiciona marcador ou inicia navegação
• Deslizar da borda: Abre menu lateral (dependendo da configuração)
• 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

🔧 12. Solução de Problemas

O mapa não carrega ou aparece em branco

• Verifique se os mapas foram baixados completamente
• 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
• 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

💬 13. 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
• Descrição detalhada do problema
• Copie cole as informações contidas em Configurações > Diagnóstico
• 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