📱 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 de download do GPSBRA
• 2 Toque no botão "Baixar Instalador (APK)"
• 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 em versão Beta através do programa TestFlight da Apple.

• 1 Entre em contato através do grupo Tracksource no WhatsApp
• 2 Informe seu nome completo e um email cadastrado na Apple
• 3 Aguarde a inclusão na lista de testadores
• 4 Você receberá um convite por email para instalar via TestFlight
• 5 Instale o TestFlight, se necessário, e aceite o convite

🚀 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. 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

🔧 11. 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

• Verifique se os arquivos JSON estão na pasta correta
• Confirme que a sintaxe JSON está correta (use um validador online)
• Certifique-se de que os nomes dos arquivos estão corretos
• Reinicie o aplicativo após copiar os arquivos