Converter KML para KMZ

O KMZ foi desenhado para resolver um problema de empacotamento. Um KML que usa ícones de marcador personalizados, uma sobreposição de foto ou uma imagem digitalizada georreferenciada referencia esses arquivos por caminho relativo, e no momento em que o documento é enviado sozinho por e-mail as referências quebram e o mapa chega em branco.

O segundo motivo é mais simples: um KML é texto verboso e texto comprime. Se o seu documento não tem recursos externos — um conjunto de marcadores, uma rota desenhada, uma exportação de banco de dados — então empacotamento não é o que você está comprando, e sim tamanho.

Medido num KML guardando uma linha única de 7.200 vértices com elevação em cada ponto, o documento tinha cerca de 258 KB e o arquivo compactado cerca de 47 KB — um fator de cinco e meio. Listas de coordenadas estão perto do caso ideal para um deflate: cada entrada compartilha um prefixo com a anterior, os separadores se repetem sempre.

Um documento feito de muitos marcadores curtos comprime pior, porque a taxa é dominada pela marcação de elemento repetida em vez dos números que de fato variam. A garantia é mais estreita do que parece: o gravador mantém a forma sem compressão quando deflate não ajudaria, então o payload nunca cresce.

Esta é a parte a entender antes de converter. A conversão não pega o seu KML e o comprime. Ela interpreta o documento na mesma forma interna compartilhada que todo formato GPS deste site atravessa — pontos com posição, elevação opcional, horário opcional, agrupados em linhas e marcadores nomeados — e escreve um KML novo a partir dessa forma, que só então é compactado.

A consequência é que o KML dentro do arquivo compactado não é idêntico byte a byte ao seu, e na maioria dos casos nem chega perto. Vai ser mais curto, seus elementos estarão em outra ordem, e tudo que a forma interna não tem onde colocar estará ausente.

Especificamente: definições de estilo e as referências a elas, então cor, espessura e ícones personalizados de linha desaparecem. Balões de descrição, incluindo qualquer HTML dentro deles. Dados estendidos e campos personalizados tipados por esquema, onde geralmente mora qualquer coisa derivada de banco de dados. Agrupamento em pastas, já que a forma interna tem uma lista plana só. Câmeras salvas, que não são restauradas. Links de rede, sobreposições de solo e de tela por completo.

O que sobrevive é a geometria e os rótulos: todo ponto vira um marcador com um ponto, toda linha vira um marcador com uma linha, e cada um mantém o nome que tinha. Para um arquivo cujo conteúdo é onde as coisas estão e como se chamam, isso é tudo. Para um mapa de apresentação estilizado, é uma pequena fração.

Se o KML carrega estilo ou descrições que você precisa, o pacote fiel é um que você monta à mão. Renomeie seu documento para doc.kml, adicione a um arquivo ZIP de forma que fique na raiz em vez de dentro de uma pasta, e renomeie o arquivo compactado de .zip para .kmz.

A posição na raiz é o detalhe que as pessoas erram. Um KMZ cujo KML fica um diretório abaixo abre em alguns leitores e falha silenciosamente em outros, e a falha parece um mapa vazio em vez de um erro.

Um link de rede é um KML que não contém dado nenhum: guarda uma URL e instruções de atualização, e tudo que você vê ao abri-lo foi buscado de um servidor depois que o arquivo carregou. Camadas de trânsito ao vivo, conjuntos de dados por assinatura e mapas de equipe compartilhados são feitos assim.

Alimentado a esta conversão, um arquivo assim não produz marcadores nem linhas, e o resultado é a mensagem de que nenhuma trilha ou waypoint foi encontrado. Esse é o resultado correto, e diz algo útil: o mapa que você estava olhando nunca esteve no arquivo.

O Google Earth, ao salvar um KMZ, percorre o documento em busca de todo recurso referenciado e copia cada um para o arquivo, reescrevendo os caminhos conforme avança. Essa coleta é a substância do que uma ferramenta de autoria de KMZ faz, e esta conversão não tenta isso.

O resultado guarda um documento e nenhum recurso, então um KML referenciando arquivos de ícone locais produz um arquivo menor que o esperado.

Compressão não é o único jeito de tornar um KML grande manejável, e às vezes é o errado. Um documento de 40 MB lento no Google Earth está lento por causa do número de feições que desenha, e compactá-lo para 7 MB muda o tempo de transferência e nada sobre a renderização.

Se o problema é desempenho em vez de transferência, os consertos são estruturais: divida o arquivo por região ou camada, afine linhas densas.

O documento é interpretado, reescrito e compactado nesta aba do navegador. Nenhuma requisição o carrega para lugar nenhum, o que pode ser confirmado no painel de rede durante uma conversão, e a página continua funcionando com a conexão desligada.

Isso vale mais que o usual para este par específico, porque a alternativa óbvia é um site de compressão de arquivos. Um KML de sites, clientes, ativos ou imóveis é dado empresarial com localização anexada, e a rota usual para diminuí-lo envolve entregar a um servidor de estranhos, esperar, e baixar de volta.