Validador e Reparador GeoJSON

Ferramenta gratuita de validação e reparo GeoJSON. Valide sintaxe GeoJSON, detecte erros e corrija automaticamente problemas comuns.

clearClearpastePaste
Upload
Arraste e solte arquivo GeoJSON aqui
ou clique para procurar

O que é Validador e Reparador GeoJSON?

O Validador e Reparador GeoJSON é uma ferramenta online gratuita que valida arquivos GeoJSON, detecta erros comuns e corrige problemas automaticamente. Garante que seus dados GeoJSON estejam em conformidade com os padrões e prontos para uso em aplicações de mapeamento.

A validação GeoJSON é crucial para aplicações de mapeamento web. GeoJSON inválido pode causar erros de renderização, falhas de aplicação ou comportamento inesperado em bibliotecas como Leaflet, Mapbox e OpenLayers.

Esta ferramenta não apenas valida seu GeoJSON mas também fornece capacidades de reparo automático, corrigindo problemas comuns como coordenadas duplicadas, ordem de enrolamento incorreta e geometrias malformadas.

Erros Comuns do GeoJSON

Este validador detecta e corrige os seguintes problemas:

  • Propriedade 'type' ausente ou inválida
  • Formato ou ordem de coordenadas incorretos
  • Coordenadas fora dos limites válidos (-180 a 180, -90 a 90)
  • Coordenadas duplicadas ou redundantes
  • Anéis de polígono não fechados
  • Ordem de enrolamento incorreta do polígono (regra da mão direita)
  • Propriedades vazias ou nulas
  • Estrutura inválida de Feature ou FeatureCollection

Como Usar o Validador GeoJSON

Usar o validador é direto:

  • Cole seus dados GeoJSON ou envie um arquivo .geojson
  • Clique em Validar para verificar erros
  • Revise os resultados da validação e problemas detectados
  • Selecione opções de reparo para corrigir problemas automaticamente
  • Clique em Reparar e Validar para gerar GeoJSON corrigido
  • Baixe o GeoJSON reparado ou copie para uso

A ferramenta fornece mensagens de erro detalhadas mostrando exatamente o que está errado e onde o problema ocorre na sua estrutura GeoJSON.

Capacidades de Reparo

A função de reparo pode corrigir automaticamente:

  • Remover coordenadas consecutivas duplicadas em LineStrings e Polígonos
  • Limpar coordenadas redundantes usando Turf.js cleanCoords
  • Corrigir ordem de enrolamento do polígono para seguir a regra da mão direita (exterior horário, buracos anti-horário)
  • Remover objetos de propriedades vazios ou valores nulos
  • Limitar coordenadas aos limites válidos (-180 a 180 longitude, -90 a 90 latitude)
  • Fechar anéis de polígono não fechados automaticamente

Após o reparo, a ferramenta revalida o GeoJSON para garantir que todos os problemas foram resolvidos.

Aplicações e Casos de Uso

Este validador é útil para:

  • Validar GeoJSON antes de usar em aplicações de produção
  • Depurar geração de GeoJSON de bancos de dados ou APIs
  • Limpar arquivos GeoJSON enviados por usuários
  • Garantir compatibilidade de GeoJSON entre diferentes bibliotecas de mapeamento
  • Corrigir problemas de precisão de coordenadas e pontos redundantes
  • Preparar GeoJSON para armazenamento e transmissão eficientes

Padrões de Validação GeoJSON

Esta ferramenta valida contra a especificação oficial GeoJSON (RFC 7946):

  • Tipos de geometria corretos: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, GeometryCollection
  • Formato de coordenada válido: [longitude, latitude] ou [longitude, latitude, elevação]
  • Limites de coordenadas: longitude [-180, 180], latitude [-90, 90]
  • Anéis de polígono: primeira e última coordenadas devem ser idênticas (anel fechado)
  • Ordem de enrolamento: anel exterior horário, anéis interiores anti-horário
  • Propriedades de Feature: devem ser um objeto (pode ser vazio ou nulo)

Seguir esses padrões garante que seu GeoJSON funcione corretamente em todas as implementações compatíveis.

Sobre o Validador e Reparador GeoJSON

O Validador e Reparador GeoJSON verifica qualquer documento GeoJSON em relação à especificação RFC 7946, sinaliza erros estruturais, problemas geométricos e de metadados e, em seguida, repara automaticamente os mais comuns - coordenadas consecutivas duplicadas, propriedades vazias de Feature, anéis de polígono não fechados, ordens de coordenadas misturadas e geometrias nulas perdidas. Útil para analistas GIS limpando dados de campo, desenvolvedores web depurando fontes de tiles, engenheiros de dados montando pipelines espaciais e qualquer um que exporte do QGIS, ArcGIS ou scripts próprios e precise que o arquivo carregue limpo no Leaflet, Mapbox ou Turf.js sem surpresas. Experimente também Geocodificador e Geohash Encoder Decoder.

Perguntas Frequentes

Valida sua entrada contra a RFC 7946 (a especificação GeoJSON), checando que o objeto raiz seja FeatureCollection, Feature ou Geometry; que toda geometria tenha exatamente a estrutura requerida pelo tipo declarado (coordenadas Point de comprimento 2 ou 3, LineString com pelo menos 2 posições, anéis de Polygon fechados e orientados corretamente); e que as coordenadas estejam dentro das faixas WGS84 válidas (longitude ±180, latitude ±90). Também verifica que nomes de propriedades sejam strings, que campos bbox sejam arrays de comprimento 4 ou 6, e que membros crs estejam ausentes (RFC 7946 os proíbe; apenas EPSG:4326 é permitido).

Reparos automáticos comuns: fechar anéis de Polygon cujas primeira e última coordenadas não coincidem; inverter anéis externos invertidos (RFC 7946 exige externos anti-horários e furos horários); corrigir a ordem de enrolamento com a regra da mão direita; converter coordenadas em string para números; remover propriedades extra não permitidas pela especificação; achatar MultiPoint/MultiLineString/MultiPolygon de elemento único para seus equivalentes não-multi; e remover membros crs proibidos. Cada reparo é reportado com o caminho do elemento afetado para que você possa revisar a alteração antes de aceitá-la.

RFC 7946 exige que anéis externos de Polygons sejam enrolados em sentido anti-horário vistos de cima (a regra da mão direita, mesma convenção usada por OGC Simple Features) e que anéis internos (furos) sejam enrolados em sentido horário. Essa convenção importa porque algoritmos de ponto-em-polígono e alguns renderizadores (notavelmente Mapbox GL e deck.gl) se baseiam nela para decidir qual lado é o interior. Se seus dados foram exportados por uma ferramenta que usa a convenção oposta (alguns shapefiles ESRI antigos), furos podem renderizar como sólidos e o interior do polígono como transparente. O reparo reorienta todos os anéis para a ordem conforme RFC.

O antimeridiano é a linha de longitude em ±180 graus, onde os hemisférios leste e oeste se encontram. Uma LineString ou Polygon que o cruza pode ser codificada de duas formas: como um único feature cuja longitude salta de +179 para -179 (que a maioria dos renderizadores desenhará como uma linha envolvendo todo o globo), ou como MultiLineString/MultiPolygon com a geometria dividida no antimeridiano. RFC 7946 recomenda a forma dividida para evitar renderização envolvente. O validador sinaliza qualquer feature cujo bounding box abranja mais de 180 graus de longitude, e o reparo pode dividir a geometria no antimeridiano ou deixá-la com aviso.

A ferramenta segue a RFC 7946 (junho de 2016), o padrão GeoJSON atual. Rascunhos antigos e variantes como a especificação de 2008, GeoJSON-T (extensão de tempo) e GeoJSON-LD (extensão de dados ligados) são parcialmente suportados via parsing em modo solto: features com membros estrangeiros são aceitos mas sinalizados com aviso, e propriedades de tempo passam inalteradas. Membros CRS do rascunho de 2008 são aceitos mas reportados como inválidos segundo RFC 7946, com opção de removê-los automaticamente. Para TopoJSON (formato relacionado mas distinto), use o conversor dedicado de TopoJSON.

Causas comuns: (1) latitude e longitude trocadas, geometricamente inócuo mas renderiza no país errado; (2) coordenadas em um CRS projetado como UTM (valores na ordem de milhões) nunca reprojetadas para WGS84; (3) valores DMS não convertidos para decimal; (4) altitudes colocadas por engano onde deveria ir longitude ou latitude. O validador exibe cada valor fora de faixa com seu índice de feature e caminho de propriedade para que você corrija nos dados fonte. Após corrigir, execute o validador novamente até não haver erros antes de implantar o arquivo em um mapa de produção.

Para arquivos abaixo de 50 MB, validação e reparo completam em segundos. Entre 50 e 200 MB, espere 10 a 60 segundos e uso de memória notável em dispositivos abaixo de 4 GB de RAM. Acima de 200 MB, convém dividir o arquivo por região ou rodar um validador server-side como jsonschema com o schema GeoJSON, ou usar ogr2ogr -f GeoJSON -t_srs EPSG:4326 para validar e reprojetar em uma passagem. O validador do navegador usa parsing JSON Streaming quando possível (cerca de 30 por cento mais rápido que parsing DOM completo em arquivos grandes), mas a pressão de heap continua sendo o fator limitante em hardware de consumo.

Sim. A ferramenta pode exportar o relatório de validação como JSON com uma entrada por erro ou aviso, incluindo caminhos JSON-pointer ao elemento ofensor. Você pode integrá-lo em CI rodando a mesma biblioteca de validação (o pacote npm open-source @placemarkio/check-geojson ou geojson-validation) e fazendo o build falhar quando algum erro aparecer. Para mapas em produção recomendamos política de dois níveis: avisos tolerados mas registrados, erros bloqueando deploy. Isso captura desvios introduzidos por exportações upstream, especialmente quando provedores terceiros atualizam seus schemas sem aviso.
Validador e Reparador GeoJSON — Ferramenta gratuita de validação e reparo GeoJSON. Valide sintaxe GeoJSON, detecte erros e corrija automaticamente probl
Validador e Reparador GeoJSON