Converter KMZ para KML

O primeiro é manual: renomeie o arquivo de .kmz para .zip, abra e retire o documento — você fica com exatamente o que o autor salvou, com todo estilo, descrição e pasta intactos, além das imagens que viajaram junto. Nada se perde porque nada foi interpretado. Custa uns quinze segundos e nenhum programa.

O segundo é esta conversão, que lê o documento e escreve um novo contendo a geometria e os nomes. É um arquivo menor e mais simples que o original, e às vezes é exatamente disso que você precisa: um importador que rejeita um KML complexo, um script que espera um formato específico de documento.

A saída é um documento KML 2.2 com um elemento Document, um nome se a origem tinha um, e uma lista plana de Placemarks. Todo ponto do arquivo vira um Placemark com um Point; toda linha vira um Placemark com um LineString marcado para seguir o relevo. Os nomes são mantidos em todos.

É o arquivo inteiro. Não há bloco de estilo, sem styleUrl, sem descrição, sem dados estendidos e sem pastas aninhadas, o que o torna incomumente fácil de ler e editar: um placemark tem quatro ou cinco linhas.

Arquivos produzidos por organizações costumam ser estilizados, porque foram feitos para serem vistos. Espere definições de estilo com cores de linha e ícones customizados, balões de descrição contendo HTML e às vezes tabelas inteiras, dados estendidos carregando os campos de banco de dados de cada elemento, e uma árvore de pastas agrupando por camada ou fase. Nada disso aparece na saída.

Duas coisas mais valem menção à parte. Uma sobreposição de terreno — uma planta escaneada ou uma imagem aérea sobre o relevo — não é lida de jeito nenhum, então um arquivo cujo conteúdo real é uma imagem converte para um documento quase vazio. E um link de rede guarda uma URL em vez de dados, então um KMZ construído em torno de um produz zero placemarks.

Dentro dele, o membro principal costuma se chamar doc.kml, na raiz do arquivo em vez de numa pasta. É o que o Google Earth escreve e o que os leitores procuram primeiro. Quando o arquivo vem de outro software, o documento pode ter o nome da camada, então o padrão é pegar o primeiro membro cujo nome termine em .kml.

Isso importa se você for reempacotar algo na mão. Um KMZ cujo documento fica um diretório abaixo abre em alguns leitores e mostra um mapa vazio em silêncio em outros, geralmente porque alguém compactou a pasta em vez do arquivo de dentro.

Se o arquivo tem uma trilha gx:Track — a geometria do Google para trajetos GPS, guardando listas paralelas de horários e posições — as posições são lidas junto com os horários. Mas o escritor produz um LineString, que guarda só coordenadas, então os horários não têm para onde ir e são descartados na saída.

O resultado é uma forma onde a entrada era uma gravação, e o controle deslizante de tempo do Google Earth não vai aparecer para ela. Se os horários importam, esta é a conversão errada — a certa é KMZ para GPX, onde cada ponto tem um elemento de tempo e a gravação continua sendo uma gravação.

Elementos Document e Folder são percorridos recursivamente, então um placemark aninhado três níveis abaixo é encontrado. O que o percurso não faz é preservar onde eles estavam: tudo sai numa lista única.

Para um KMZ organizado por camada, isso é uma perda real de estrutura: "Fase 1 / Confirmado / Local 14" e "Fase 3 / Proposto / Local 14" viram dois placemarks chamados "Local 14" um do lado do outro. Se o agrupamento é informação que você precisa, tem que ser dobrado no nome do placemark antes de converter.

Um KMZ é menor que o KML que carrega, então descompactar sempre custa bytes. Medido aqui, um documento de cerca de 258 KB comprimiu para uns 47 KB dentro do arquivo — um fator de cinco e meio, porque texto de coordenadas é um dos melhores casos para compressão deflate.

Expandir de volta é a maior parte do trabalho desta conversão. O limite prático é o teto de 100 MB aplicado ao arquivo compactado, mas o número que você vai encontrar primeiro numa publicação grande é a memória da aba do navegador.

O arquivo é descompactado, interpretado e reescrito dentro desta aba do navegador. Nada é transmitido, o que o painel de rede mostra durante uma conversão, e a página continua funcionando com a conexão desligada depois de carregada.

Essa é a resposta prática para um problema comum. Um KMZ de um cliente, contratante ou órgão público costuma vir com termos sobre onde pode ser armazenado, e o jeito mais rápido de olhar dentro de um seria normalmente uma ferramenta web que violaria esses termos sem ninguém perceber.