Converter CSV para GeoJSON

Este conversor transforma um CSV com colunas de latitude e longitude ou uma coluna WKT em GeoJSON, lidando com o ponto e vírgula, a vírgula decimal e a codificação do Windows que o Excel costuma usar. O CSV é lido no seu navegador e não é enviado. Endereços não são geocodificados, coordenadas em graus, minutos e segundos não são suportadas, e linhas sem coordenadas válidas são mantidas com geometria nula.

Um arquivo não foi convertido corretamente? Escreva para [email protected], de preferência com um pequeno arquivo de exemplo, e o problema será corrigido.

O essencial

De CSV para GeoJSON: por que converter?

Listas de lojas, sensores, avistamentos ou clientes muitas vezes nascem no Excel ou no Google Sheets, com uma linha por lugar e uma coluna de latitude e outra de longitude. Para colocá-las em um mapa web, você precisa de GeoJSON. Este conversor encontra sozinho as colunas de coordenadas quando elas têm nomes comuns como lat, latitude, lon, lng, longitude, x ou y, ou usa uma coluna de texto WKT como POINT (12.57 55.68), que também permite linhas e polígonos. Ele lida com as variantes de CSV que o Excel gera em cada país: vírgula ou ponto e vírgula, ponto decimal ou vírgula decimal, UTF-8 ou a antiga codificação do Windows. Se as colunas não forem reconhecidas, você mesmo as escolhe. Todas as outras colunas viram propriedades. O arquivo é lido no seu navegador e nunca é enviado.

Como converter CSV para GeoJSON

  1. Arraste e solte seu arquivo .csv na caixa ou clique para escolhê-lo.
  2. Confira as colunas usadas para as coordenadas e informe o sistema de coordenadas se elas não forem longitude e latitude.
  3. Clique em “Converter” e baixe seu arquivo GeoJSON.

O que muda na conversão

Como as colunas de coordenadas são encontradas

Uma coluna cujos valores parecem WKT é usada primeiro como geometria. Caso contrário, a coluna de longitude ou X é a primeira cujo nome começa com lon, lng ou long, ou é x ou easting, e a coluna de latitude ou Y é a primeira que começa com lat, ou é y ou northing. O resumo mostra quais colunas foram usadas, e você pode escolher outras. Um ponto em Copenhague com latitude e longitude trocadas vai parar no Mar da Arábia, então vale a pena olhar o mapa antes de converter. Endereços não são transformados em coordenadas; o arquivo precisa ter números ou WKT.

Ponto e vírgula e vírgula decimal

No Brasil, na Alemanha, na França e em muitos outros países, o Excel salva arquivos CSV com ponto e vírgula entre as colunas e vírgula como separador decimal, então 55,6813 significa 55.6813. O separador (vírgula, ponto e vírgula, tabulação ou barra vertical) é detectado pela linha de cabeçalho, e uma primeira linha “sep=” do Excel é respeitada. Vírgulas decimais são entendidas em arquivos separados por ponto e vírgula ou tabulação; em um arquivo separado por vírgulas, a vírgula só pode ser separador. Em um arquivo com vírgulas decimais, números com separador de milhar, como 1.200, ficam como texto. Coordenadas em graus, minutos e segundos, como 55°40'52"N, não são suportadas; converta-as antes para graus decimais.

Codificação do texto

UTF-8, com ou sem marca de ordem de bytes, e UTF-16 são reconhecidos. Um arquivo que não é UTF-8 válido é lido como Windows-1252, a codificação que o Excel no Windows usa para “CSV (separado por vírgulas)” na Europa Ocidental e nas Américas, então letras como ç, ã, é e ñ são preservadas. Outras codificações antigas, como páginas de código cirílicas ou asiáticas, não são detectadas; salve esses arquivos antes como “CSV UTF-8”.

Números, texto e células vazias

Uma coluna só vira número no GeoJSON quando todos os seus valores são números. Valores com zero à esquerda, como o código postal 0800 ou o ID 000123, mantêm a coluna como texto, então nada se perde. As colunas de coordenadas não são repetidas como propriedades. Linhas com coordenada vazia ou ilegível são mantidas com "geometry": null, e a página informa quantas são.

O sistema de coordenadas

Um CSV não diz em que sistema de coordenadas estão seus números. Longitude e latitude são consideradas WGS84, como as de um GPS ou do Google Maps. Quando os valores claramente não são graus, por exemplo coordenadas UTM leste e norte em metros, a página pede o código EPSG, como EPSG:31983 ou EPSG:31982, e reprojeta para WGS84. Valores EWKT com SRID=... preenchem o código para você.

Sobre os formatos

CSV

CSV (valores separados por vírgula) é uma tabela em texto simples que abre no Excel, no Google Planilhas e em qualquer banco de dados. Não tem um tipo de geometria próprio: as localizações ficam em duas colunas de coordenadas, como latitude e longitude, ou em uma coluna de texto WKT.

  • Pontos cabem em duas colunas (X e Y, ou longitude e latitude); linhas e polígonos precisam de uma coluna WKT.
  • O sistema de coordenadas não fica salvo no arquivo, então anote-o à parte.
  • Não há padrão para o separador: o Excel usa vírgula ou ponto e vírgula, conforme as configurações de idioma.
  • Todo valor é texto; se 01310 é um número ou um CEP, quem decide é o programa que o lê.

GeoJSON

GeoJSON é um formato de texto JSON para feições geográficas, padronizado como RFC 7946 em 2016. É o formato nativo de mapas web como Leaflet, MapLibre e Mapbox, e de muitas APIs.

  • As coordenadas são longitude e latitude WGS84 (nessa ordem).
  • Pontos, linhas e polígonos podem ser misturados em um mesmo arquivo.
  • As propriedades podem ser qualquer valor JSON, sem limite de tamanho nos nomes de campo.

Perguntas frequentes

Meu CSV é enviado?

Não. O arquivo é lido e convertido pelo seu próprio navegador, então listas de clientes e outros endereços privados ficam no seu computador.

Que opção do Excel devo usar para salvar o CSV?

“CSV UTF-8 (delimitado por vírgulas)” é a mais segura, porque mantém todos os caracteres. A opção “CSV” comum também funciona; o conversor lê sua codificação do Windows e, em países com vírgula decimal, seus pontos e vírgulas.

O CSV pode conter linhas e polígonos?

Sim, em uma coluna WKT. Cada linha da planilha guarda uma geometria, por exemplo LINESTRING (12.56 55.67, 12.57 55.68) ou um POLYGON ou MULTIPOLYGON. Coordenadas de pontos em duas colunas só podem gerar pontos.

Funciona com o Google Sheets?

Sim. No Google Sheets, escolha Arquivo, Fazer download, Valores separados por vírgula e solte esse arquivo aqui.