Converter KML para GPX

Quase todo KML que acaba precisando desta conversão foi feito clicando. Alguém traçou uma rota no Google Earth, soltou pinos numa camada do Meu Mapas, ou exportou um plano de uma ferramenta cujo único export é KML. Esse arquivo descreve uma intenção: é aqui que a linha deveria passar. Um GPX de um relógio descreve um histórico: é aqui que o receptor estava, nesses instantes, nesta altitude.

A conversão move a geometria da primeira forma para a forma da segunda, e tudo que faz de uma gravação uma gravação simplesmente não está na origem para ser movido. Isso não é defeito do conversor, e vale entender antes de olhar o resultado e achar que algo deu errado: o perfil de elevação plano, a duração ausente e os cantos angulosos são propriedades do desenho, fielmente transportadas.

Cada LineString vira um `<trk>` contendo um único `<trkseg>`, com um `<trkpt>` por vértice, num documento GPX 1.1. O nome do placemark vira o nome da trilha, então um aparelho que mostra uma lista de trilhas vai mostrar como você chamou a linha no Google Earth, não o nome do arquivo.

É deliberadamente uma trilha e não uma `<rte>`. GPX distingue os dois: uma rota é uma lista esparsa de pontos para navegar entre eles, uma trilha é uma linha densa para seguir. Aparelhos portáteis mais antigos tratam os dois de forma diferente, e alguns oferecem avisos de curva para uma rota e nenhum para uma trilha. Se seu aparelho especificamente quer uma rota, converter a trilha depois é trabalho do próprio software do aparelho — o Garmin BaseCamp faz isso — em vez de algo que uma conversão de formato deveria decidir por você.

Um LineString guarda coordenadas e nada mais, então o GPX sai sem o elemento `<time>` em nenhum ponto de trilha. O arquivo é válido — tempo é opcional no GPX 1.1, e uma rota não tem porque reivindicar um —, e todo app de navegação vai carregar e seguir sem problema.

Onde isso morde é no upload. Uma plataforma que trata um GPX como atividade concluída precisa calcular duração e ritmo, e não consegue fazer isso sem dois carimbos para subtrair. Suba a rota desenhada como rota ou percurso, o recurso feito exatamente para esse arquivo, em vez de como atividade. Se um serviço recusar o arquivo reclamando de dado de tempo ausente, é isso que ele está avisando, e inventar carimbos produziria uma atividade que afirma uma velocidade que ninguém pedalou.

Uma coordenada KML tem um terceiro valor opcional em metros. O Google Earth, ao desenhar uma linha grudada no terreno, escreve esse terceiro valor como `0` em cada vértice, porque a altitude não tem sentido quando o renderizador vai colocar a linha sobre o chão de qualquer jeito. A conversão pega o número ao pé da letra, então cada ponto de trilha ganha `<ele>0</ele>` e seu aparelho desenha um perfil plano ao nível do mar, sem subida nenhuma.

Um export do Meu Mapas costuma se comportar diferente, escrevendo só dois valores por coordenada, caso em que nenhum elemento `<ele>` é escrito — o resultado mais honesto, e que parece idêntico na maioria dos aparelhos. De qualquer jeito, a elevação precisa vir de outro lugar. A maioria dos planejadores de rota vai regenerar a partir de um modelo de terreno na importação, e esse número é melhor que o zero de qualquer forma, já que vem de um levantamento e não de um receptor balançando numa encosta.

A conversão escreve exatamente tantos pontos de trilha quanto o KML tinha vértices, e nunca interpola. Uma rota de um dia inteiro traçada clicando costuma ter de quarenta a duzentos vértices; a mesma rota gravada por um relógio a uma amostra por segundo tem trinta mil. Num mapa com pouco zoom, os dois parecem idênticos. Aproximando, a desenhada corta cantos, atravessa um rio onde não há ponte, e segue reto por uma curva fechada.

Isso importa mais para qualquer coisa que mede. Distância calculada sobre uma polilinha grosseira é sistematicamente curta, porque toda curva foi substituída pela sua corda, e uma descida de montanha com quinze curvas em ferradura pode perder uma fração relevante do comprimento. Se o número importa, planeje a rota numa ferramenta que se ajusta à rede de estradas ou trilhas — o resultado é mais denso e segue a geometria real.

Um Placemark contendo um `<Point>` vira um `<wpt>` GPX na mesma posição, mantendo o nome que tinha. Pontos de interesse são escritos antes das trilhas no arquivo, a ordem convencional e a que aparelhos portáteis esperam. Na maioria dos aparelhos, aparecem como pontos de interesse selecionáveis, navegáveis independentemente da rota.

Esta é frequentemente a metade mais útil da conversão. Uma camada de trinta pinos — pontos de água, portões, camping, pontos de encontro — vira trinta entradas rotuladas num relógio, o que nenhuma quantidade de olhar para uma linha de rota entrega. Os nomes são carregados literalmente, então vale encurtá-los antes de converter: uma tela mostrando onze caracteres corta «Ponto de reabastecimento de água perto da ponte» para algo inútil.

Duas construções do KML voltam sem nada. Um `<Polygon>` — uma fronteira, uma área com permissão, uma região sombreada — guarda seu contorno dentro de elementos de fronteira aninhados que este leitor não abre, então uma área não contribui trilha nenhuma. Um `<MultiGeometry>`, que envolve várias linhas ou pontos dentro de um Placemark, é ignorado pelo mesmo motivo estrutural.

Se o arquivo inteiro for feito assim, a conversão para e avisa que nenhuma trilha ou ponto de interesse foi encontrado, o que é preciso e não uma falha de tentar. O contorno, quando é isso que você quer seguir, é reabrir o KML no Google Earth e redesenhar a fronteira como um caminho — um Polygon e um LineString parecem iguais na tela e são objetos diferentes no arquivo.

Se o KML veio de um export de GPS em vez de um desenho, ele pode ter um `gx:Track` em vez de um LineString: a extensão do Google, guardando uma lista de carimbos `<when>` junto com uma lista correspondente de posições `<coord>`. É lido como um caso distinto, e os carimbos são carregados diretamente para o elemento `<time>` de cada ponto de trilha GPX.

Essa diferença sozinha muda para que a saída serve. Um GPX convertido de um gx:Track é uma gravação, com duração e ritmo, e sobe como atividade igual a qualquer outra. O jeito rápido de saber que tipo de KML você tem é buscar `when` no arquivo — se a string estiver ali, espere carimbos no GPX; se não estiver, espere nenhum.

Placemarks aninhados em elementos Document e Folder são encontrados percorrendo a árvore, o que é necessário porque um export do Meu Mapas põe cada camada na própria pasta e um KML de uma ferramenta de planejamento pode ter três níveis de profundidade. Os nomes das pastas em si não são carregados: GPX não tem agrupamento equivalente, e inventar um significaria adivinhar qual nível importava.

O que atravessa é o nome do Document, que vira `<metadata><name>` do GPX, e o nome de cada placemark, que vira o nome de sua trilha ou ponto de interesse. O arquivo é escrito com GPX 1.1 e um atributo de criador nomeando este conversor. Nada mais do cabeçalho do KML — descrições, definições de estilo, a posição de câmera LookAt — tem lugar num GPX.

O KML é lido e o GPX é escrito no seu navegador. Nenhuma requisição carrega o arquivo para lugar nenhum, o que dá para conferir no painel de rede enquanto a conversão roda, e a página funciona com a conexão desligada depois de carregada.

Uma rota planejada diz menos sobre você do que uma gravada, mas não muito menos. Uma linha desenhada ainda nomeia onde você pretende estar e quando, e uma camada do Meu Mapas com endereços de clientes ou visitas a imóveis é comercialmente sensível antes de ser pessoal. Converter localmente significa que o arquivo nunca vira o registro de outra pessoa, a única garantia que não depende de ler uma política de retenção.