Google KML (.kml)

OGC Padrão

O formato KML (Keyhole Markup Language) é o padrão XML aberto para expressar anotações e visualizações geográficas, desenvolvido originalmente para o Keyhole Earth Viewer (Google Earth) e padronizado pelo Open Geospatial Consortium (OGC).

Converter GEOJSON para KML

Conversor gratuito de GEOJSON para KML no navegador. Converta arquivos instantaneamente no seu dispositivo.

Inspeção e metadados

Sistemas operacionais e analisadores de arquivos identificam arquivos KML pela sequência inicial de bytes:

Selecione ou solte os arquivos aqui

Privado - os arquivos nunca saem do seu dispositivo

ou colar Ctrl+V
Garantia de privacidade sem transmissão pela rede 0 bytes enviados a servidores externos. Todo o processamento ocorreu localmente no ambiente isolado do navegador.

Assinatura do arquivo em bytes (magic bytes)

Sistemas operacionais e analisadores de arquivos identificam arquivos KML pela sequência inicial de bytes:

ASSINATURA HEXADECIMAL (DESLOCAMENTO 0):

3C 6B 6D 6C

REPRESENTAÇÃO ASCII: <kml

Padronização: OGC KML 2.3 Standard

Especificações técnicas

Estrutura do contêinerVocabulário geográfico em XML que define marcadores de lugar (Placemarks), sobreposições de terreno, modelos 3D e perspectivas de câmera
CompressãoTexto XML sem compactação (pode ser compactado em arquivos .kmz)
Ordem dos bytes (endianness)Fluxo de texto UTF-8/Unicode
Espaços de corCores hexadecimais no formato AABBGGRR
Canais e EstruturaMarcadores de lugar, caminhos, polígonos, modelos 3D de edifícios, sobreposições de fotos e trajetos de câmera em passeios virtuais
Dimensões MáximasCoordenadas WGS 84: longitude, latitude e altitude (em metros acima do nível do mar)
TransparênciaSuporte a transparência alfa em valores de cor AABBGGRR e sobreposições PNG
Streaming e ProgressivoLinks de rede permitem receber atualizações dinâmicas de servidores geográficos remotos

Matriz de comparação técnica: KML e formatos concorrentes

Atributo técnicoKML (Atual)GEOJSONGPXKMZ
Câmera 3D e ToursInclinação total da câmera, direção e tours guiadosNenhum (propriedades de geometria plana)Rastreamento de elevação de altitudeInclinação total da câmera e tours guiados
Formato de EmpacotamentoDocumento XML em texto planoDocumento JSON em texto planoDocumento XML em texto planoArquivo ZIP contendo doc.kml
Formato de CorAABBGGRR (Alfa-Azul-Verde-Vermelho)Padrão CSS / HexNenhumAABBGGRR
Destino PrincipalGoogle Earth e SIG 3DMapas web (Mapbox, Leaflet)Rastreamento de fitness Garmin e GPSArquivo autônomo do Google Earth

Modos comuns de corrupção e guia de recuperação com editor hexadecimal

Erro do Google Earth: 'Erro de análise na linha X: tag incompatível'.

Causa principal: Tag XML não fechada ou e-comercial (&) não escapado na descrição HTML do balão.

Recuperação: Repare a sintaxe XML e envolva a descrição em <![CDATA[...]]> usando a Reparação KML do File2File.app.

Análise de segurança e vetores de ataque a analisadores

Arquivos KML suportam NetworkLinks e balões de descrição HTML que podem acionar XXE, SSRF ou Cross-Site Scripting (XSS).

Vetores de ataque conhecidos

  • Server-Side Request Forgery (SSRF) por meio de tags <NetworkLink> maliciosas pesquisando endpoints de intranet internos.
  • Injeção de XSS via HTML não sanitizado dentro de tags <description> executadas em balões do Earth para desktop ou web.
  • Injeção de Entidade Externa XML (XXE) durante o processamento automatizado de KML.

Melhores práticas defensivas: Desative a busca de recursos em redes externas e sanitize o conteúdo HTML dos balões com DOMPurify.

Origens históricas e marcos

2008O Open Geospatial Consortium (OGC) adota o KML 2.2 como um Padrão Geoespacial Internacional oficial.
2005O Google adquire a Keyhole Inc., renomeando o Keyhole Earth Viewer para Google Earth e democratizando o KML globalmente.
2001A Keyhole Inc. cria o KML para anotar imagens de satélite em 3D.

Principais vantagens

  • Visualização detalhada da Terra em 3D: permite definir pontos, ângulos de câmera, direção, inclinação, altitude e passeios virtuais.
  • O suporte a KML depende da aplicação; os recursos disponíveis variam entre ferramentas GIS e de mapas para desktop.
  • As ligações NetworkLink podem obter recursos KML associados; a atualização depende das definições do documento e do visualizador.

Limitações técnicas e desvantagens

  • A sintaxe XML verbosa resulta em tamanhos de arquivo maiores do que formatos compactos como o GeoJSON.
  • As cores usam a ordem hexadecimal pouco convencional AABBGGRR (Alfa-Azul-Verde-Vermelho) em vez do RGBA padrão.
  • Recursos 3D complexos (Tours, Modelos) raramente são suportados em plataformas leves de mapeamento web.

Curiosidades técnicas

  • A Keyhole Inc. foi nomeada em homenagem aos satélites espiões históricos de reconhecimento KH (Keyhole) lançados pelos Estados Unidos durante a Guerra Fria.
  • No KML, os valores de cores são escritos ao contrário como AABBGGRR: os dois primeiros caracteres são Alfa, depois Azul, depois Verde e por fim Vermelho.
  • Um arquivo KMZ contém pelo menos um ficheiro KML e pode incluir ficheiros de apoio. doc.kml é o nome convencional do ficheiro principal, mas são permitidos outros nomes.

Perguntas técnicas frequentes

Qual é a diferença entre KML e KMZ?

O KML é um arquivo XML de texto simples. O KMZ é um arquivo ZIP compactado que contém um arquivo KML junto com ícones de mapas personalizados, texturas ou imagens de sobreposição 3D.

Como posso converter KML para GeoJSON?

Você pode converter arquivos KML do Google Earth em GeoJSON limpo para mapeamento na web com um clique usando o File2File.app diretamente no seu navegador.

Posso abrir um arquivo KML no Google Maps?

Sim! No Google Maps, vá em 'Salvos' -> 'Mapas' -> 'Criar mapa' (Google My Maps) e clique em 'Importar' para carregar o seu arquivo KML.