GeoJSON (.geojson)

IETF Padrão

GeoJSON é comum em mapas da Web, mas o suporte varia. O GitHub exibe arquivos compatíveis com limites; a RFC 7946 define longitude antes da latitude.

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 GeoJSON 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 GeoJSON pela sequência inicial de bytes:

ASSINATURA HEXADECIMAL (DESLOCAMENTO 0):

7B 0A 20 20 22 74 79 70 65 22 3A 20 22 46 65 61 74 75 72 65

REPRESENTAÇÃO ASCII: {\n "type": "Feature

Padronização: IETF RFC 7946

Especificações técnicas

Estrutura do contêinerDocumento JSON conforme o RFC 7946, que representa características, coleções de características e geometrias geográficas
CompressãoTexto sem compactação (pode ser compactado com Gzip ou Brotli durante o transporte por HTTP)
Ordem dos bytes (endianness)Fluxo de texto UTF-8
Espaços de corNão se aplica (dados geográficos)
Canais e EstruturaPontos, pontos múltiplos, linhas, linhas múltiplas, polígonos, polígonos múltiplos, coleções de geometrias e propriedades personalizadas
Dimensões MáximasSistema Geodésico Mundial de 1984 (WGS 84): longitude (-180 a +180) e latitude (-90 a +90)
TransparênciaNenhuma
Streaming e ProgressivoGeoJSON delimitado por linhas (GeoJSONL/GeoJSONSeq) permite transmitir milhões de características continuamente

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

Atributo técnicoGeoJSON (Atual)KMLGPXSHP
Adoção em Mapeamento WebPadrão SIG web 100% universalPadrão do Google EarthPadrão de dispositivos GPS e fitnessPadrão legado de SIG para desktop
Ordem de Coordenadas[Longitude, Latitude] (X, Y)Longitude, Latitude, AltitudeLatitude, LongitudeCoordenadas X, Y
Estilo de SintaxeChave-valor JSON limpoTags XML verbosas (<kml>)Tags XML verbosas (<gpx>)Binário de múltiplos arquivos (.shp, .shx, .dbf)
Esquema de PropriedadesObjeto de propriedades JSON arbitrárioTags de esquema ExtendedDataTags fixas de esquema GPXColunas fixas dBase IV (.dbf)

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

Os pontos do mapa aparecem no oceano perto da Antártica em vez de sua localização real.

Causa principal: Os valores de Latitude e Longitude foram trocados acidentalmente na matriz de coordenadas.

Recuperação: Inverta as posições das coordenadas [lon, lat] usando o Conversor GeoJSON do File2File.app.

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

As propriedades do GeoJSON podem conter entradas arbitrárias do usuário que devem ser sanitizadas antes de serem renderizadas em pop-ups de mapas para evitar XSS.

Vetores de ataque conhecidos

  • Cross-site scripting (XSS) via HTML não escapado em propriedades de feições GeoJSON renderizadas em dicas de ferramentas de mapas.
  • Negação de serviço por meio de GeometryCollections profundamente aninhadas ou polígonos de um milhão de vértices.
  • Server-Side Request Forgery via carregamento remoto de feições GeoJSON.

Melhores práticas defensivas: Higienize todas as strings de texto das propriedades com DOMPurify antes de inseri-las em janelas pop-up de mapas.

Origens históricas e marcos

2016O IETF padroniza oficialmente o formato GeoJSON como a RFC 7946, tornando obrigatórios os sistemas de referência de coordenadas WGS 84.
2014GeoJSON é comum em mapas da Web, mas o suporte varia. O GitHub exibe arquivos compatíveis com limites; a RFC 7946 define longitude antes da latitude.
2008Howard Butler, Sean Gillies e a comunidade de SIG de código aberto publicam a especificação inicial do GeoJSON 1.0.

Principais vantagens

  • Padrão web nativo: mapeia diretamente para objetos JavaScript em bibliotecas de mapeamento de navegador (Mapbox GL JS, Leaflet).
  • A estrutura JSON legível por humanos permite criação programática, filtragem e depuração sem esforço.
  • Esquema de propriedades arbitrário: anexe qualquer metadado personalizado (população, nome, velocidade, receita) diretamente às formas geométricas.

Limitações técnicas e desvantagens

  • Verbosidade de texto: armazena coordenadas de ponto flutuante como dígitos ASCII repetidos, resultando em tamanhos de arquivo maiores do que Shapefiles binários ou FlatGeobuf.
  • A RFC 7946 obriga estritamente a ordem [Longitude, Latitude], o que frequentemente confunde desenvolvedores acostumados com 'Lat/Long'.
  • Polígonos grandes com milhões de vértices podem causar lentidão na renderização do DOM do navegador web.

Curiosidades técnicas

  • O padrão oficial do GeoJSON ordena as coordenadas como [Longitude, Latitude] (ordem cartesiana X, Y), o que é exatamente o oposto de como as pessoas falam ('Latitude, Longitude').
  • GeoJSON é comum em mapas da Web, mas o suporte varia. O GitHub exibe arquivos compatíveis com limites; a RFC 7946 define longitude antes da latitude.
  • A RFC 7946 determina que os anéis de limite de polígonos devem seguir a 'regra da mão direita': os anéis externos devem ser orientados no sentido anti-horário.

Perguntas técnicas frequentes

Por que minhas coordenadas GeoJSON estão ordenadas como [longitude, latitude] em vez de [latitude, longitude]?

GeoJSON é comum em mapas da Web, mas o suporte varia. O GitHub exibe arquivos compatíveis com limites; a RFC 7946 define longitude antes da latitude.

Como posso converter KML ou Shapefile para GeoJSON?

Você pode converter arquivos KML do Google Earth ou Shapefiles da Esri em GeoJSON limpo e pronto para a web em segundos usando o File2File.app diretamente no seu navegador.

Qual é a diferença entre GeoJSON e Shapefile?

O Shapefile continua sendo muito usado para troca de dados e é compatível com softwares de GIS, mas sua estrutura com vários arquivos e as limitações de atributos podem tornar o GeoJSON ou um geodatabase mais adequado a alguns fluxos de trabalho.