Por que converter GeoJSON em Shapefile
GeoJSON é o formato que a maioria dos mapas web e das APIs entrega. Mas muito trabalho de SIG desktop, prefeituras, empresas de serviços públicos e projetos antigos de ArcGIS ainda esperam um Shapefile. Se você mandar um arquivo .geojson para essas pessoas, a resposta de costume é: "você pode me passar um shapefile?"
Os dois formatos são construídos de jeito diferente, então a conversão é mais do que trocar o nome. Um Shapefile na verdade são cinco ou seis arquivos que andam juntos. A geometria fica no arquivo .shp, um índice no arquivo .shx, a tabela de atributos no arquivo .dbf e o sistema de coordenadas no arquivo .prj. Além disso, um Shapefile só pode guardar um tipo de geometria, enquanto um arquivo GeoJSON pode misturar pontos, linhas e polígonos livremente. Esta ferramenta resolve essas diferenças para você.
Você envia um arquivo GeoJSON e recebe um único arquivo .zip. Se os seus dados misturam tipos de geometria, o zip contém um Shapefile para pontos, um para linhas e um para polígonos, então nenhuma feição se perde. Nomes longos de propriedades são encurtados para os 10 caracteres que o formato permite, e o painel de resultado mostra exatamente quais nomes mudaram. A conversão roda no seu navegador, por isso os seus dados nunca saem do seu computador.
O formato Shapefile: história, estrutura e limites
A Esri criou o Shapefile no início dos anos 1990 para o seu programa de desktop ArcView. A ideia era um formato simples e rápido, que pudesse ser lido sem um banco de dados. Em julho de 1998 a Esri publicou uma descrição técnica pública, e desde então quase todos os programas de SIG, gratuitos ou pagos, conseguem ler e escrever o formato. Esse é o principal motivo de ele ainda estar em todo lugar mais de 30 anos depois.
A tabela de atributos dentro de um Shapefile usa o formato de arquivo dBase III, que é ainda mais antigo. É daí que vêm os limites mais conhecidos. Nomes de campo podem ter no máximo 10 caracteres, um valor de texto no máximo 254 bytes, e um campo não pode guardar dados aninhados. Um arquivo .dbf também não tem um tipo de verdade para data com hora, por isso muitas ferramentas guardam esses valores como texto.
O arquivo de geometria tem limites próprios. Os deslocamentos dentro dele são números de 32 bits, então um único arquivo .shp ou .dbf não pode passar de cerca de 2 GB. Cada arquivo guarda exatamente um tipo de geometria, como pontos, polilinhas ou polígonos. Em um polígono, o anel externo deve girar no sentido horário e cada buraco no sentido anti-horário. O GeoJSON (RFC 7946, publicado em 2016) usa a ordem contrária para anéis externos, então um conversor correto precisa virar os anéis.
Nada disso faz do Shapefile um bom formato para projetos novos. GeoPackage e GeoParquet resolvem a maioria desses limites. Mas o Shapefile ainda é o formato que todo escritório, todo órgão público e todo curso de SIG conhece, então saber gerar um limpo rapidamente é útil.
Guia passo a passo

Escolha um arquivo .geojson no seu computador, cole texto GeoJSON na caixa ou clique em "Testar exemplo" para carregar um pequeno exemplo alemão com pontos, linhas e polígonos.

Confira o nome da camada. Ele vira o nome dos arquivos dentro do zip e do próprio zip. Depois clique em "Converter para Shapefile". Arquivos típicos terminam em uma fração de segundo.

Um resumo mostra uma linha por Shapefile (pontos, linhas, polígonos), a caixa delimitadora, as colunas de propriedades e os nomes de campo que precisaram ser encurtados.

As feições são desenhadas no mapa para você conferir se os dados certos foram convertidos. O mapa começa em branco. Marque "Mostrar mapa base" se quiser blocos de ruas sob os dados.

Clique no botão de download para salvar o arquivo .zip. Descompacte-o e abra o arquivo .shp no QGIS, no ArcGIS ou em qualquer outro programa de SIG.
Seis casos de uso reais
Situações em que as pessoas precisam de um Shapefile mesmo que os dados tenham começado como GeoJSON.
- Enviar dados para um usuário de ArcGIS. Um colega ou cliente trabalha no ArcGIS Desktop e pede um Shapefile. Você exporta GeoJSON de uma ferramenta web e converte aqui em poucos segundos.
- Entregar dados a um órgão público. Muitos departamentos de planejamento e de licenças só aceitam Shapefiles. Um zip com os arquivos .shp, .shx, .dbf e .prj é exatamente o que o formulário de envio deles pede.
- Usar dados de mapas web em software mais antigo. Programas de topografia, complementos de CAD e alguns programas de engenharia não leem GeoJSON. Quase sempre conseguem importar um Shapefile.
- Limpar um download de API. Você buscou feições em uma API web e quer vê-las em um SIG desktop. Converter para Shapefile dá um arquivo padrão com um .prj correto, para a camada se alinhar com os seus outros dados.
- Ensino e trabalhos de curso. Muitos cursos de SIG ainda distribuem exercícios em Shapefile. Os alunos podem exportar os próprios dados GeoJSON e convertê-los aqui sem instalar o GDAL.
- Passar dados para uma equipe de impressão ou cartografia. Designers de mapas costumam trabalhar em ferramentas que importam Shapefiles por padrão. Separar dados misturados em arquivos distintos de pontos, linhas e polígonos facilita estilizar cada camada.
Perguntas e respostas técnicas
Dez perguntas comuns sobre como este conversor funciona, respondidas de forma direta.
1. Quais arquivos vêm dentro do zip que eu baixo?
Para cada tipo de geometria você recebe cinco arquivos com o mesmo nome base. O arquivo .shp tem as formas, o arquivo .shx é um índice de onde cada forma começa, o arquivo .dbf é a tabela de atributos, o arquivo .prj informa o sistema de coordenadas e o arquivo .cpg diz que o texto é UTF-8. Mantenha-os juntos. Um arquivo .shp sozinho não é um Shapefile completo.
2. Meu GeoJSON tem pontos, linhas e polígonos. O que acontece?
Um Shapefile só pode guardar um tipo de geometria, então o conversor escreve um Shapefile por tipo e coloca todos no mesmo zip. Os arquivos recebem um sufixo, por exemplo converted_points, converted_lines e converted_polygons. Se os seus dados têm um só tipo, não há sufixo.
3. Qual sistema de coordenadas o resultado usa?
WGS 84 com longitude e latitude (EPSG:4326). O GeoJSON é definido nesse sistema, então os números são copiados como estão e um arquivo .prj correspondente é escrito. Se o seu GeoJSON usa outro sistema de forma fora do padrão, reprojete-o antes para WGS 84, porque esta ferramenta não faz reprojeção.
4. Por que alguns dos meus nomes de campo mudaram?
O formato dBase dentro de um Shapefile permite só 10 caracteres por nome de campo. Um nome como population_estimate vira population, e quando dois nomes ficariam iguais, um número é acrescentado, por exemplo a_very_lon e a_very_lo1. Caracteres que não sejam letras, dígitos ou sublinhados são trocados por um sublinhado. O painel de resultado lista cada mudança.
5. O que acontece com números, valores verdadeiro/falso e texto?
Inteiros e decimais viram campos numéricos, com as casas decimais definidas pelo máximo que qualquer feição usa. Valores verdadeiro e falso viram campos lógicos. Texto vira um campo de caracteres tão largo quanto o valor mais longo, até 254 bytes. Se uma propriedade mistura tipos, por exemplo números em algumas feições e texto em outras, a coluna inteira é guardada como texto.
6. O que acontece com objetos e arrays aninhados nas propriedades?
Uma tabela de Shapefile é plana, então um objeto ou array é escrito como uma cadeia de texto JSON em um campo de caracteres. Você pode lê-lo de volta com qualquer ferramenta JSON. Valores com mais de 254 bytes são cortados, e o painel de resultado informa quantos foram cortados.
7. Os buracos dos polígonos e o sentido dos anéis estão corretos?
Sim. O conversor lê a área com sinal de cada anel e o vira quando preciso, de modo que anéis externos giram no sentido horário e buracos no sentido anti-horário, como a especificação do Shapefile exige. Feições MultiPolygon são escritas como um registro com vários anéis externos e seus buracos.
8. E as coordenadas 3D e as feições sem geometria?
Só X e Y são escritos, então qualquer valor de altura (Z) é descartado, e o painel de resultado avisa. Feições com geometria nula ou inutilizável são puladas, e o painel mostra quantas. As propriedades delas também não são escritas, porque uma linha de Shapefile precisa de uma forma.
9. Funciona com arquivos grandes?
Funciona bem com arquivos de várias dezenas de megabytes, porque todo o trabalho roda na memória do seu navegador. Arquivos muito grandes podem ficar lentos ou esgotar a memória em um celular. Um único Shapefile também não pode passar de cerca de 2 GB, o que é um limite do próprio formato.
10. O meu arquivo GeoJSON é enviado a um servidor?
Não. A leitura, a escrita dos cinco arquivos e a compactação em zip acontecem dentro do seu navegador. O seu arquivo nunca sai do seu dispositivo, e nenhuma parte da conversão toca um servidor.
Como o Shapefile é montado, byte a byte
Não há palpite na conversão. Cada parte do resultado segue um layout fixo de bytes da especificação da Esri. Veja o que a ferramenta faz com os seus dados.
1. Uma família de geometria por arquivo
Primeiro a ferramenta lê cada feição e coloca a geometria dela em um de três grupos: pontos (Point, MultiPoint), linhas (LineString, MultiLineString) e polígonos (Polygon, MultiPolygon). Uma GeometryCollection é dividida em suas partes, e cada parte vai para o seu grupo. Cada grupo não vazio vira o seu próprio Shapefile, com o seu próprio código de tipo de forma: 1 para ponto, 8 para multiponto, 3 para polilinha e 5 para polígono.
2. Layout de .shp, .shx e .dbf
O arquivo .shp começa com um cabeçalho de 100 bytes. Ele contém o código de arquivo 9994, a versão 1000, o tipo de forma e a caixa delimitadora. Depois vem um registro por feição. Cada registro tem um cabeçalho de 8 bytes (número do registro e comprimento, ambos em big-endian) e depois o conteúdo, cujo tamanho depende da forma. Uma polilinha ou um polígono com p partes e n pontos precisa de 4 + 32 + 4 + 4 + 4p + 16n bytes de conteúdo:
.shp header = 100 bytes: 9994 | file length | 1000 | shape type | bbox record = 8-byte header + content (record number, length in 16-bit words) Point = 4 + 16 = 20 bytes MultiPoint(n) = 4 + 32 + 4 + 16n PolyLine/Polygon(p parts, n points) = 4 + 32 + 4 + 4 + 4p + 16n (r = records, f = fields) .shx = 100 + 8r .dbf = 32 + 32f + 1 | r records of (1 + sum of field widths) | 0x1A
O tamanho é exato, então a ferramenta pode alocar o buffer uma vez só e escrever cada número com um DataView. Uma linha simples com 3 pontos e 1 parte ocupa 4 + 32 + 4 + 4 + 4 + 48 = 96 bytes de conteúdo, mais 8 bytes de cabeçalho de registro. O arquivo .shx repete o deslocamento e o comprimento de cada registro, por isso ele sempre tem 100 + 8r bytes.
3. Virar os anéis dos polígonos
O sentido de um anel é encontrado com a fórmula da área de Gauss (shoelace). Para pontos (x, y) em ordem, a área com sinal é a soma de (x_prev + x) * (y_prev - y) dividida por 2. Um resultado negativo significa sentido horário. O GeoJSON quer anéis externos no sentido anti-horário, e um Shapefile os quer no sentido horário, então todo anel externo com área positiva é invertido. Os buracos seguem a regra oposta. Os anéis também são fechados se o primeiro e o último ponto forem diferentes.
4. Dimensionar a tabela de atributos
O cabeçalho do .dbf tem 32 + 32f + 1 bytes, e cada linha é um caractere de espaço (a marca de "não excluído") mais a largura de cada campo. Para escolher uma largura, a ferramenta mede cada valor. Para texto, usa o maior comprimento em bytes UTF-8 (no máximo 254). Para números, usa o maior número de dígitos antes da vírgula, mais o maior número de casas decimais encontrado, mais um para o ponto e um para o sinal de menos se algum valor for negativo. Um número é escrito com toFixed e preenchido à esquerda com espaços até a largura do campo.
Como cada tamanho é calculado antes de qualquer coisa ser escrita, o resultado é determinístico: o mesmo GeoJSON convertido duas vezes dá os mesmos bytes de .shp, .shx e .dbf. Só a data guardada no cabeçalho do .dbf muda de um dia para o outro.
A conversão roda inteiramente no seu navegador. Os arquivos Shapefile são escritos pelo código próprio deste site e empacotados com JSZip. Nenhum arquivo é enviado a um servidor. Mapas base opcionais © colaboradores do OpenStreetMap, desenhados com Protomaps (hospedado por KONAKTIVE), com CARTO como reserva.
