O que é um arquivo GPX?

GPX é um formato de texto puro que abre em qualquer editor. Ele é usado para mapas e o registro esportivo.

A extensão é .gpx e o nome por extenso é GPS Exchange Format. Os dois importam menos do que aquilo que o arquivo consegue carregar, e é disso que trata o resto desta página.

A Topografix publicou o formato em 2002. A especificação é GPX 1.1.

A idade interessa por um motivo prático: quanto mais antigo o formato, mais programas tiveram tempo de aprendê-lo.

Ela está publicada por inteiro, então dá para implementá-la a partir do documento em vez de por observação — é por isso que o formato aparece em tantos programas e por isso que arquivos escritos há vinte anos ainda abrem. Especificação publicada não é o mesmo que livre de royalties: quando o formato embrulha um codec, o licenciamento das patentes é uma questão à parte, que a norma não resolve.

GPX guarda o conteúdo exatamente. Salvar de novo não muda nada, então dá para abrir, editar e salvar quantas vezes você quiser sem acumular estrago — e é isso que faz dele um formato de trabalho e não de entrega.

Garmin BaseCamp, Strava e QGIS leem esse formato, e a maioria dos programas do mesmo tipo também.

Quando um arquivo não abre, o formato raramente é o problema — mais comum é o programa ser mais antigo que ele. Converter para algo mais antigo é o caminho confiável, e é para isso que serve o resto deste site.

Nenhum navegador lê o formato.

Esse é de longe o motivo mais comum para convertê-lo: não que o formato seja ruim, mas que o lugar onde você quer mostrar o arquivo não consegue lê-lo.

GPX foi feito para ser aberto e alterado. Mantenha o arquivo nesse formato enquanto o trabalho estiver em andamento e exporte a partir dele sempre que precisar de uma cópia pronta.

Waypoints são pontos marcados isolados: um estacionamento, um pico, uma fonte de água. Uma rota é uma lista ordenada de pontos descrevendo para onde você pretende ir, sem nada sobre tempo. Uma trilha (track) é um registro de por onde você realmente passou — uma série densa de pontos, cada um com um horário, normalmente um por segundo.

A distinção entre rota e trilha é a que causa confusão. Carregar uma trilha num aparelho de navegação esperando uma rota pode fazer o aparelho recusar, ou tentar dar instruções ponto a ponto ao longo de dez mil pontos. Converter uma trilha em rota exige simplificá-la para umas poucas dezenas de pontos. Saber qual das duas você tem é a primeira pergunta, e qualquer editor de texto responde.

GPX é XML, está estável desde 2004, e é o único formato que todo relógio de GPS, ciclocomputador, aplicativo de trilha e site de mapas lê e escreve ao mesmo tempo. Essa universalidade é o motivo de ele existir: cada fabricante tinha seu próprio formato proprietário, e o usuário queria seus dados em outro lugar.

É deliberadamente minimalista. Um ponto é latitude, longitude e, opcionalmente, elevação e horário. Tudo além disso — frequência cardíaca, cadência, potência, temperatura — mora em extensões, um mecanismo de escape que cada fabricante preencheu de um jeito. Funciona, e é por isso que a frequência cardíaca às vezes sobrevive a uma transferência e às vezes não.

Essa é a tarefa do dia a dia do formato. Exportar do Strava, Garmin Connect, Komoot, Wahoo ou Polar e importar em outro lugar é um arquivo GPX passando entre eles, e o motivo de fazer isso quase sempre é estar deixando uma plataforma ou querer um backup que sobreviva à assinatura.

A trilha, os horários e a elevação viajam de forma confiável. O que frequentemente não viaja é tudo que a plataforma acrescentou por cima: o tipo de atividade, título e descrição, voltas, o fluxo de frequência cardíaca se estava guardado numa extensão de fabricante. Conferir uma atividade importada antes de subir mais quatrocentas vale os dois minutos.

Um GPS de consumo deriva altitude da geometria dos satélites, e nisso ele é ruim — erros de dez a vinte metros são comuns. Aparelhos com altímetro barométrico se saem bem melhor, e derivam com o clima. Nenhum dos dois produz um número de ganho total que se possa comparar com o de outra pessoa.

É por isso que as plataformas recalculam. A maioria descarta a elevação registrada e consulta um modelo de terreno próprio, e modelos diferentes discordam — essa é a explicação completa de por que o mesmo pedal mostra 640 metros de subida num site e 710 noutro. Nenhum dos dois está mentindo; estão consultando mapas diferentes.

Planeje no computador, onde dá para ver o mapa direito, exporte GPX, e carregue no relógio ou ciclocomputador — pelo aplicativo do fabricante ou copiando o arquivo para o aparelho conectado como uma unidade de armazenamento.

Duas coisas para conferir antes de sair. Quantidade de pontos: alguns aparelhos limitam uma rota a algumas centenas de pontos e vão truncar ou recusar silenciosamente um arquivo com milhares, então simplifique antes de exportar. E direção: um GPX tem uma ordem, e um circuito planejado no sentido horário será navegado no sentido horário. As duas coisas são triviais de corrigir na mesa e irritantes de descobrir num cruzamento.

Como o arquivo é XML puro, dá para consertar bastante coisa manualmente. Uma gravação em que o relógio foi ligado cedo e ficou rodando no carro tem uma cauda espúria que pode ser apagada. Uma data errada é uma linha. Uma trilha que foi pausada e retomada pode ser unida.

O único cuidado é que os horários estão em UTC. Editá-los para bater com o horário local produz uma atividade internamente consistente e que mostra a hora errada em qualquer plataforma que a converta de volta. Mude os pontos, não o relógio.

GPX é para dados de atividade e navegação: uma trilha com horários, uma rota a seguir, waypoints a encontrar. É o formato que os aparelhos falam. KML é para apresentação — marcadores, linhas estilizadas, áreas coloridas, imagens fixadas no mapa — e é o formato que o Google Earth fala.

Converter uma trilha para KML para exibir num mapa é razoável, e o estilo tem que ser acrescentado porque o GPX não tem noção disso. Converter no sentido contrário merece atenção, porque um KML com polígonos e sobreposições tem muita coisa que o GPX não consegue expressar, e o que chega do outro lado é só o que sobreviveu à tradução.