Converter KMZ para GPX

KMZ é o formato em que órgãos e organizações publicam. Parques, associações de trilha, organizadores de prova e agrimensores exportam de ferramentas que produzem arquivos do Google Earth, e o formato de arquivo compactado é preferido porque viaja como um anexo só e parece um mapa quando aberto. Nada disso ajuda quando o percurso precisa acabar num pulso.

Relógios, ciclocomputadores e apps de navegação são construídos em torno do GPX. A conversão pega o que o publicador desenhou e reescreve na forma que o aparelho espera: linha vira track, alfinete vira waypoint, nome vai junto. O que o publicador colocou em volta da geometria — estilo, imagem, estrutura de pastas — não é o que um aparelho segue e não sobrevive.

Um KMZ é um ZIP cujo membro principal é um documento KML. O leitor descompacta no navegador e procura primeiro por um membro chamado doc.kml, o nome que o Google Earth grava ao salvar. Quando o arquivo veio de outra ferramenta, o documento pode ter qualquer nome, então o recurso é usar o primeiro membro terminando em .kml.

Esse recurso não é decoração defensiva: exportações de software GIS costumam nomear o documento pelo nome da camada, e um pacote de uma equipe de agrimensura pode ter Rota_final_v3.kml e nada chamado doc. Se não houver membro KML nenhum, a conversão para com uma mensagem, quase sempre significando que o arquivo é um ZIP renomeado de outra coisa.

Abra um KMZ publicado como ZIP e o KML costuma ser a coisa menor lá dentro. Ao lado ficam os gráficos de alfinete que o mapa usa, uma imagem de legenda, às vezes um mapa impresso georreferenciado sobreposto ao terreno, ocasionalmente fotos fixadas em pontos de vista.

GPX não tem elemento para nada disso. Um waypoint GPX é uma posição, um nome e opcionalmente um comentário — sem imagem, sem estilo, sem sobreposição. Então a conversão escreve a geometria e deixa o resto no pacote, que é a única opção honesta.

Toda LineString em qualquer lugar do documento vira um <trk> com um <trkseg>, mantendo o nome do placemark como nome da track. Todo Placemark com um <Point> vira um <wpt> com seu nome. Waypoints são escritos primeiro, a ordem convencional que aparelhos portáteis esperam.

Os nomes valem checar antes de sincronizar: eles chegam ao pé da letra, e um KMZ publicado costuma nomear feições para uma legenda, não para uma tela pequena. Renomear tracks e waypoints depois é uma edição de cinco minutos num editor de texto.

Boa parte dos KMZ publicados por órgãos descreve regiões: um lote de caça, uma zona de permissão, uma área de risco de incêndio, um limite de propriedade. São feições <Polygon>, e o contorno delas vive dentro de elementos de fronteira aninhados que este leitor não percorre — então elas não produzem track alguma.

Quando o próprio limite é o que você quer seguir, abra o KMZ no Google Earth e retrace o contorno com a ferramenta de caminho, depois converta o resultado. Um placemark <MultiGeometry>, que agrupa várias linhas numa entrada só, é ignorado pelo mesmo motivo estrutural.

Uma coordenada KML pode carregar altitude como terceiro valor, e a conversão escreve isso em <ele> quando presente. O problema é o que publicadores de fato escrevem: uma linha desenhada no Google Earth e grudada ao terreno carrega altitude zero em todo vértice, então o GPX chega com um perfil plano no nível do mar.

Um aparelho mostrando esse arquivo reporta subida zero, leitura correta dos dados recebidos. Planejadores de rota geralmente recalculam elevação a partir do próprio modelo de terreno na importação, e o resultado costuma ser melhor do que o que um receptor mediria de qualquer forma.

A maioria das rotas publicadas não carrega tempo algum, porque uma LineString guarda coordenadas e nada mais. O GPX então não tem elemento <time> em nenhum ponto da track, o que é válido — tempo é opcional no GPX 1.1 — e significa que o arquivo é um percurso a seguir, não uma atividade já realizada.

A exceção é um pacote construído a partir de uma exportação de GPS, onde o documento pode ter um gx:Track com listas paralelas de timestamps e posições. Esses timestamps são lidos e levados ao GPX. O teste rápido é buscar "when" no KML.

Publicadores costumam entregar uma rede em vez de uma rota só: oito trilhas sinalizadas, um conjunto de alternativas, um percurso principal mais seus atalhos. Toda linha do documento vira sua própria track, então o GPX sai com todas elas, cada uma nomeada como o placemark foi nomeado.

Aparelhos variam em como lidam com isso: alguns listam cada track e deixam escolher, alguns concatenam tudo numa rota implausível que pula entre pontos de partida. Se o seu aparelho fizer a coisa errada, dividir o GPX em um arquivo por track resolve.

O tamanho de um KMZ diz pouco sobre quanta geometria há dentro. Texto de coordenadas comprime extremamente bem — um KML medido aqui em cerca de 258 KB descompactou para cerca de 47 KB —, então um pacote pequeno pode carregar um documento cinco vezes maior e centenas de milhares de vértices.

O limite gratuito aqui é 100 MB para o pacote como está, e na prática a memória da aba do navegador é o que se atinge primeiro numa publicação grande. Se um arquivo grande travar, renomear para .zip e olhar o tamanho descompactado do membro KML é o diagnóstico útil.

O pacote é descompactado, interpretado e reescrito dentro desta aba do navegador. Nenhuma requisição carrega o arquivo para lugar nenhum, o que o painel de rede confirma, e a página continua funcionando offline depois de carregada.

Para um arquivo recebido, o argumento vale nos dois sentidos. Um KMZ de agrimensura ou cliente costuma chegar sob termos que restringem onde pode ser guardado, e colar num conversor web é exatamente a transferência que esses termos existem para evitar.