Antes de usar um GPX que você recebeu, diferencie o formato do arquivo do tipo de informação que ele guarda. A extensão GPX, sozinha, não diz se é uma rota planejada ou o registro de uma caminhada. A especificação do GPX 1.1 ajuda a reconhecer as estruturas. Confira à parte a finalidade do arquivo e os requisitos do aplicativo de destino. A quantidade de pontos e a aparência da linha não indicam de onde vieram os dados.
Confira primeiro a versão do GPX e o conteúdo do arquivo
A especificação do GPX 1.1 descreve como o mesmo arquivo pode reunir pontos de referência (waypoints), rotas e traçados. Tanto o elemento rte, de rota, quanto o trk, de traçado, podem aparecer várias vezes. Um arquivo pode conter rotas e traçados ao mesmo tempo. Mesmo que o nome inclua “rota”, verifique quais elementos estão no arquivo e como o aplicativo os mostra.
Observe também a versão. O manual de GPX 1.0 para desenvolvedores da TopoGrafix já informa na abertura que trata do formato antigo GPX 1.0. Aqui, a explicação da estrutura segue a documentação do GPX 1.1. A redação sugere conferir primeiro se a versão do manual que você encontrou é a mesma do arquivo recebido.
Para ver o conteúdo, guarde o original e examine uma cópia. Se as informações no aplicativo não mostrarem a versão ou o tipo de dados, você pode abrir a cópia como texto, sem apagar nem reescrever elementos. O que você não conseguir confirmar, como a versão ou um elemento, pode ficar em aberto.
Na rota, procure rtept. No traçado, trkseg e trkpt.
No GPX 1.1, rte representa uma rota, com pontos de passagem ordenados, como os locais onde é preciso mudar de direção para chegar ao destino. O elemento trk representa um traçado, uma sequência de pontos que descreve um caminho. Os pontos de uma rota são rtept. Os segmentos do traçado aparecem como trkseg, e seus pontos como trkpt. Para distinguir os tipos, veja onde esses elementos estão na estrutura.
Uma rota não precisa ter poucos pontos, nem um traçado precisa ter muitos pontos próximos. As definições consultadas não usam a quantidade de pontos para distinguir os tipos. Mesmo com linhas visualmente parecidas, confirme a estrutura e a finalidade em separado. Se o aplicativo não mostrar o nome dos elementos, consulte a documentação oficial para ver como reconhecer o tipo. O nome exibido na tela não revela sozinho o conteúdo do arquivo.
Um trkseg reúne pontos do traçado em uma sequência contínua. Quando o sinal GPS cai ou o receptor é desligado, a especificação orienta a usar um novo trkseg para cada parte contínua. A existência de vários segmentos não explica por que o arquivo foi dividido. Verifique separadamente como ele foi criado ou editado.
Distinga o tipo de dados da origem, seja um plano ou um registro
A estrutura permite identificar uma rota ou um traçado, mas quem criou o arquivo e com qual objetivo são perguntas diferentes. A presença de trk não comprova que a pessoa andou pelo caminho e o registrou. Ao receber o arquivo, guarde a explicação da fonte sobre ele ser um plano, um registro em movimento ou um arquivo editado ou convertido.
No GPX 1.1, o elemento metadata é opcional, assim como os campos que ele contém, como nome, descrição, autor e data e hora. Já os atributos version e creator são obrigatórios no arquivo. A ausência de dados opcionais sobre autoria é diferente da falta de um atributo obrigatório. Um nome que parece ser o do autor não confirma quem fez o registro nem para que o arquivo foi criado.
Anote quem enviou o arquivo, quando ele chegou, qual era a finalidade declarada e o que não pôde ser verificado. Se a origem ou a data de criação forem desconhecidas, evite deduzi-las pela linha ou pelo nome do arquivo. A redação sugere essas anotações para evitar confusão sobre a origem. O nome dos elementos GPX não informa como está a trilha hoje nem se ela está transitável.
Separe os campos do formato dos requisitos de importação do aplicativo
No GPX 1.1, rtept e trkpt usam o tipo wptType. Os atributos de latitude e longitude são obrigatórios. Elevação (ele) e data e hora (time) são opcionais. Ter ou não altitude ou horário não basta para distinguir uma rota de um traçado. Marque um campo ausente como “não informado”, sem colocar altitude zero ou duração zero no lugar.
Cada serviço tem seus próprios requisitos. A documentação para desenvolvedores explica que o Strava segue o GPX 1.1 e exige data e hora em cada ponto do traçado ao enviar um arquivo de atividade. A central de ajuda informa que, sem essas marcações nas coordenadas, o serviço não consegue calcular velocidade nem tempo nos segmentos, então rejeita o envio. Um campo opcional no GPX pode ser obrigatório em determinado serviço.
A central de ajuda dá os GPX baixados de atividades de outros usuários como exemplo de arquivos sem marcações de horário. Se você não conseguir um arquivo com essas informações, o Strava indica a opção de criar uma atividade manual. Essas são as regras de envio do Strava. Outros aplicativos de mapas podem ter requisitos diferentes. A rejeição não justifica mudar o tipo do ponto ou inventar os horários que faltam.
Resumo: anote separadamente tipo, estrutura, origem e finalidade
Separe a versão do GPX, as rotas e os traçados contidos nele, os segmentos dos traçados, os campos presentes, a explicação da fonte e o uso previsto no aplicativo. Encontrar trk, receber uma explicação de que o arquivo é um registro com horários e confirmar que o aplicativo pode usá-lo são três informações diferentes. Deixe como não verificado o que não puder confirmar.
Interrupções entre segmentos, altitudes ausentes e horários merecem verificações próprias. Comece identificando rotas e traçados pela estrutura original. A densidade dos pontos não basta. Consulte a documentação oficial do aplicativo para entender como ele desenha linhas, lida com arquivos atualizados com o mesmo nome e preenche campos ausentes.
Importar um GPX com sucesso não comprova que o caminho é transitável. Mantenha explícitas as dúvidas sobre sua finalidade ou origem. Use o formato para identificar o tipo de dados e confira separadamente as condições atuais da trilha.