Visualizador de Coordenadas dos Municípios do Brasil

📍 Coordenadas dos Municípios do Brasil

Dados carregados diretamente do arquivo https://www.areadetrampo.com.br/wp-content/uploads/2025/07/municipios_brasil_coordenadas.json.

Observação: O site Área de Trampo optou por publicar o resultado JSON e não o html que gera o JSON para não sobrecarregar o acesso a base do IBGE.

Importante:Observe sempre a data de atualização.

⏳ Carregando JSON...

📘 Documentação técnica da solução

O JSON foi gerado a partir das seguintes fontes a seguir:

1. Por que usamos a constante `CAPITAIS`?

A API de Localidades do IBGE não expõe um campo que marque explicitamente qual município é a capital de cada estado. Ela organiza os dados apenas por hierarquia geográfica (regiões → estados → municípios), sem um atributo do tipo "capital": true.

Por isso, usamos a constante CAPITAIS como uma tabela de referência com os nomes oficiais das 27 capitais brasileiras (26 estados + Distrito Federal). Essa tabela é usada para identificar qual município de cada estado é a capital e para incluir os campos capital_estado, latitude_capital e longitude_capital no JSON final.

O conteúdo da constante é:

{
  "AC": { "nome": "Rio Branco",  "lat": -9.9747, "lon": -67.8076 },
  "AL": { "nome": "Maceió",      "lat": -9.6658, "lon": -35.7353 },
  "AP": { "nome": "Macapá",      "lat":  0.0349, "lon": -51.0694 },
  "AM": { "nome": "Manaus",      "lat": -3.1190, "lon": -60.0217 },
  "BA": { "nome": "Salvador",    "lat": -12.9777, "lon": -38.5016 },
  "CE": { "nome": "Fortaleza",   "lat": -3.7319, "lon": -38.5267 },
  "DF": { "nome": "Brasília",    "lat": -15.7801, "lon": -47.9292 },
  "ES": { "nome": "Vitória",     "lat": -20.3155, "lon": -40.3128 },
  "GO": { "nome": "Goiânia",     "lat": -16.6869, "lon": -49.2648 },
  "MA": { "nome": "São Luís",    "lat": -2.5387, "lon": -44.2825 },
  "MT": { "nome": "Cuiabá",      "lat": -15.6014, "lon": -56.0979 },
  "MS": { "nome": "Campo Grande","lat": -20.4697, "lon": -54.6201 },
  "MG": { "nome": "Belo Horizonte","lat": -19.9167, "lon": -43.9345 },
  "PA": { "nome": "Belém",       "lat": -1.4558, "lon": -48.5039 },
  "PB": { "nome": "João Pessoa", "lat": -7.1195, "lon": -34.8450 },
  "PR": { "nome": "Curitiba",    "lat": -25.4284, "lon": -49.2733 },
  "PE": { "nome": "Recife",      "lat": -8.0476, "lon": -34.8770 },
  "PI": { "nome": "Teresina",    "lat": -5.0892, "lon": -42.8019 },
  "RJ": { "nome": "Rio de Janeiro","lat": -22.9068, "lon": -43.1729 },
  "RN": { "nome": "Natal",       "lat": -5.7945, "lon": -35.2110 },
  "RS": { "nome": "Porto Alegre","lat": -30.0346, "lon": -51.2177 },
  "RO": { "nome": "Porto Velho", "lat": -8.7608, "lon": -63.8999 },
  "RR": { "nome": "Boa Vista",   "lat":  2.8235, "lon": -60.6758 },
  "SC": { "nome": "Florianópolis","lat": -27.5954, "lon": -48.5480 },
  "SP": { "nome": "São Paulo",   "lat": -23.5505, "lon": -46.6333 },
  "SE": { "nome": "Aracaju",     "lat": -10.9472, "lon": -37.0731 },
  "TO": { "nome": "Palmas",      "lat": -10.1689, "lon": -48.3317 }
}

Importante: as coordenadas das capitais nesta constante foram obtidas da tabela oficial "Localização geográfica, altitude dos Municípios das Capitais e distância a Brasília", publicada pelo IBGE. Elas apontam para o centro da sede administrativa da capital. Já as coordenadas dos municípios obtidas pela API de Malhas correspondem ao primeiro ponto do polígono do contorno do município, não ao centro urbano.

2. O que consultamos em cada endpoint do IBGE

🔹 `https://servicodados.ibge.gov.br/api/v1/localidades/estados`

O que é: API de Localidades v1 — endpoint que lista todas as unidades federativas (UFs) do Brasil.

Informação extraída:

id — código numérico do estado (ex.: 35 para SP)
sigla — sigla da UF (ex.: "SP")
nome — nome completo do estado (ex.: "São Paulo")
regiao — região à qual o estado pertence (ex.: "Sudeste")

Usamos para: percorrer todos os 27 estados brasileiros (incluindo o DF) e obter a lista de UFs para as consultas seguintes.

🔹 `https://servicodados.ibge.gov.br/api/v1/localidades/estados/{uf}/municipios`

O que é: API de Localidades v1 — endpoint que lista todos os municípios de uma UF específica.

Informação extraída:

id — geocódigo do município (ex.: 3550308 para São Paulo)
nome — nome do município
microrregiao / mesorregiao — divisões geográficas intermediárias
regiao-imediata / regiao-intermediaria — divisões atualizadas

Usamos para: obter a lista completa e atualizada de municípios de cada estado, que depois é usada para buscar as coordenadas na API de Malhas.

Sobre o Distrito Federal: a API retorna apenas 1 "município" para o DF, chamado "Brasília" (geocódigo 5300108). Isso ocorre porque o DF não é dividido em municípios, mas em Regiões Administrativas — e o IBGE o trata como um único ente municipal para fins estatísticos.

🔹 `https://servicodados.ibge.gov.br/api/v4/malhas/municipios/{geocodigo}?formato=application/vnd.geo+json`

O que é: API de Malhas v4 — endpoint que retorna a geometria (polígono) de um município em formato GeoJSON.

Informação extraída:

geometry.type — tipo da geometria (Polygon ou MultiPolygon)
geometry.coordinates — array de coordenadas no formato [longitude, latitude]

Usamos para: obter o primeiro ponto do polígono do município e extrair sua latitude e longitude.

Por que o primeiro ponto? A API de Malhas retorna o contorno completo do município (que pode ter milhares de pontos). Usamos o primeiro ponto como referência de localização. Ele fica no limite do município, não no centro urbano. Para o centro da sede, seria necessário usar uma API de geocodificação (como Nominatim/OpenStreetMap).

3. Sobre a data da última atualização

O JSON gerado inclui dois campos que registram o momento em que foi produzido:

data_ultima_atualizacao — data e hora no formato ISO 8601 (ex.: 2026-09-27T09:15:45.123Z), ideal para uso programático e ordenação.
data_ultima_atualizacao_br — data e hora no formato brasileiro legível (ex.: 27/09/2026 09:15:45), ideal para leitura humana.

A data é registrada no início da execução e atualizada ao final, garantindo que o campo reflita o momento exato em que o JSON foi concluído. O nome do arquivo baixado também inclui a data (ex.: municipios_brasil_coordenadas_2026-09-27.json), facilitando o versionamento.

4. Resumo das fontes de dados

Informação	Fonte
Lista de estados (UFs)	API de Localidades v1 — `/estados`
Lista de municípios por UF	API de Localidades v1 — `/estados/{uf}/municipios`
Coordenadas dos municípios	API de Malhas v4 — `/malhas/municipios/{geocodigo}`
Nome e coordenadas das capitais	Constante `CAPITAIS` (tabela oficial do IBGE)
Data da última atualização	Gerada localmente no momento da execução