Back to all posts

Como Exportar Locais Salvos do Google Maps como GeoJSON: Guia Completo

Aprenda como exportar seus locais salvos do Google Maps como GeoJSON com instruções passo a passo, incluindo soluções para o desafio de geocodificação.

July 20, 2025

•

7 min read

O GeoJSON se tornou o formato padrão para dados geográficos na web. Se você está construindo um mapa personalizado, trabalhando com bibliotecas de mapeamento modernas ou fazendo análise espacial em Python ou R, o GeoJSON é provavelmente o que você precisa. O problema: o Google Maps não exporta seus locais salvos no formato GeoJSON - ou qualquer formato com coordenadas reais.

Este guia cobre como tirar seus locais salvos do Google Maps e colocá-los em arquivos GeoJSON adequados.

O Que é GeoJSON?

GeoJSON é um padrão aberto para codificar dados geográficos usando JSON (JavaScript Object Notation). Diferente de formatos mais antigos como KML ou Shapefile, o GeoJSON é legível por humanos, fácil de analisar e nativamente suportado por virtualmente todas as bibliotecas de mapeamento modernas e ferramentas GIS.

Um arquivo GeoJSON simples se parece com isto:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "name": "Cafeteria Favorita",
        "category": "Starred"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [-122.4194, 37.7749]
      }
    }
  ]
}

Cada local se torna uma "Feature" com propriedades (nome, notas, categoria) e geometria (as coordenadas). Esta estrutura funciona perfeitamente com ferramentas como Leaflet, Mapbox GL JS, D3.js, QGIS e bibliotecas geoespaciais Python como GeoPandas.

Por Que Escolher GeoJSON?

Desenvolvimento web: Se você está construindo um mapa web com Leaflet, Mapbox ou qualquer biblioteca de mapeamento JavaScript, GeoJSON é o formato nativo. Nenhuma conversão necessária.

Ciência de dados: GeoPandas do Python, pacote sf do R e outras ferramentas de análise trabalham diretamente com GeoJSON. É o padrão para dados espaciais em pipelines de dados modernos.

Interoperabilidade: GeoJSON é um padrão OGC e funciona entre plataformas. Seus dados não estão presos em nenhum ecossistema particular.

Legibilidade: Diferente de formatos binários, você pode abrir um arquivo GeoJSON em qualquer editor de texto e entender o que está lá. Isso torna a depuração e edições manuais diretas.

Não é o formato que você precisa? Se você está carregando locais em um dispositivo GPS ou aplicativo outdoor, formato GPX é mais apropriado. Para visualização no Google Earth, veja nosso guia KML.

O Problema das Coordenadas Ausentes

O Google Takeout exporta seus locais salvos como arquivos CSV com nomes, endereços e URLs - mas sem coordenadas. GeoJSON requer coordenadas (essa é a parte "Geo"), então você precisa geocodificar seus locais antes de converter para GeoJSON.

Como Exportar e Converter para GeoJSON

Passo 1: Baixar do Google Takeout

  1. Vá para o Google Takeout
  2. Clique em "Desmarcar tudo"
  3. Encontre e selecione apenas "Saved"
  4. Clique em "Próxima etapa" → "Criar exportação"
  5. Aguarde o e-mail, baixe e descompacte

Você encontrará arquivos CSV na pasta "Saved" - um para cada uma de suas listas.

Passo 2: Geocodificar e Converter

Os arquivos CSV precisam de coordenadas adicionadas antes que possam se tornar GeoJSON. Um serviço de geocodificação como Takeout Tools lida com ambas as etapas: faça upload de seus CSVs, selecione GeoJSON como formato de saída e baixe o resultado.

Para desenvolvedores que preferem lidar com isso programaticamente, o fluxo de trabalho é:

  1. Analisar os arquivos CSV
  2. Geocodificar cada endereço usando Google Geocoding API, Nominatim ou outro serviço
  3. Construir features GeoJSON a partir dos resultados
  4. Exportar como uma FeatureCollection

Passo 3: Usar Seu GeoJSON

Seu GeoJSON exportado está pronto para uso em qualquer ferramenta compatível:

Bibliotecas de mapeamento web:

// Leaflet
L.geoJSON(yourGeoJSON).addTo(map);

// Mapbox GL JS
map.addSource('places', { type: 'geojson', data: yourGeoJSON });

Python (GeoPandas):

import geopandas as gpd
places = gpd.read_file('saved-places.geojson')

QGIS: Camada → Adicionar Camada → Adicionar Camada Vetorial, selecione seu arquivo GeoJSON

Kepler.gl: Arraste e solte o arquivo diretamente na interface

Detalhes da Estrutura GeoJSON

Após a conversão, seu GeoJSON seguirá esta estrutura:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "name": "Nome do Local",
        "address": "Rua Principal 123, Cidade",
        "notes": "Suas notas aqui",
        "list": "Starred Places",
        "url": "https://maps.google.com/..."
      },
      "geometry": {
        "type": "Point",
        "coordinates": [longitude, latitude]
      }
    }
  ]
}

Note que o GeoJSON usa a ordem [longitude, latitude] (x, y), que é o oposto de como o Google Maps tipicamente exibe coordenadas. Esta é uma fonte comum de confusão mas está correto de acordo com a especificação GeoJSON.

Dicas Profissionais

  1. Valide seu GeoJSON. Use nosso validador GeoJSON gratuito para verificar se seu arquivo é válido antes de usá-lo em produção. GeoJSON inválido pode causar falhas silenciosas em bibliotecas de mapeamento.

  2. Mantenha a precisão de coordenadas razoável. Seis casas decimais é suficiente para locais salvos. Mais precisão apenas aumenta o tamanho do arquivo sem adicionar acurácia útil.

  3. Use o objeto properties. As propriedades do GeoJSON podem conter qualquer metadado - use-as para filtragem e estilização. Por exemplo, atribua cores diferentes com base na propriedade list.

  4. Considere o tamanho do arquivo. Se você tem milhares de locais, o GeoJSON pode ficar grande. Para aplicações web, considere carregar dados dinamicamente ou usar vector tiles para conjuntos de dados muito grandes.

  5. Preserve seus arquivos fonte. Mantenha os arquivos CSV originais do Google Takeout. Se você precisar regenerar ou converter para formatos diferentes depois, você terá os dados brutos.

Perguntas Frequentes

Por que o GeoJSON usa ordem longitude-latitude ao invés de latitude-longitude?

O GeoJSON segue a convenção matemática de coordenadas (x, y), onde longitude é o eixo x e latitude é o eixo y. A maioria das bibliotecas de mapeamento espera esta ordem e exibirá seus pontos na localização errada se você trocá-los.

Posso converter GeoJSON para outros formatos?

Sim. Ferramentas como ogr2ogr (parte do GDAL), QGIS ou conversores online podem transformar GeoJSON em KML, GPX, Shapefile e outros formatos. GeoJSON é um bom formato "fonte de verdade" porque é amplamente suportado.

Como eu estilizo meu GeoJSON em um mapa?

O GeoJSON em si não contém informações de estilo. Você aplica estilos na sua biblioteca de mapeamento:

  • Leaflet: Use a opção style em L.geoJSON()
  • Mapbox: Defina estilos na sua especificação de estilo de mapa
  • QGIS: Clique com o botão direito na camada → Propriedades → Simbologia

E se eu tiver tipos diferentes de locais?

Use a propriedade list (que corresponde às suas listas do Google Maps) para diferenciar. No seu código de mapeamento, você pode filtrar ou estilizar com base nesta propriedade - por exemplo, mostrando restaurantes em uma cor e marcos em outra.

O GeoJSON é bom para grandes conjuntos de dados?

O GeoJSON funciona bem para centenas ou alguns milhares de pontos. Para conjuntos de dados maiores (dezenas de milhares de pontos), considere alternativas como vector tiles, TopoJSON (GeoJSON comprimido) ou carregar dados de uma API ao invés de um arquivo estático.

Exporte para GeoJSON

Converta locais salvos para mapas web e APIs

Experimente Takeout Tools →

Ferramentas Gratuitas

Já tem um arquivo GeoJSON? Use nossas ferramentas gratuitas baseadas no navegador:

Veja Outros Guias de Exportação

Procurando por formatos de saída diferentes?

Como Exportar Locais Salvos do Google Maps como GeoJSON: Guia Completo | Takeout Tools