IBGE — API de Localidades e API de Malhas
Fonte primária oficial
Instituto Brasileiro de Geografia e Estatística — IBGE
Prontidão para IA
- Forma de acesso(campo volátil)
- APIs de serviço de dados do IBGE: Localidades para a organização territorial, Malhas para as representações geográficas.
- Autenticação
- Não há autenticação indicada na documentação examinada.
- Licença / termo(campo volátil)
- NÃO ENCONTRADO instrumento nominal de licença específico para estas APIs.
- Granularidade
- A documentação afirma que, salvo rotas específicas como países, os identificadores retornados pela API de Localidades são os OFICIALMENTE DESIGNADOS PELO IBGE. Há rotas de municípios, estados, regiões e demais divisões.
- Cadência
- Acompanha as atualizações da divisão territorial.
- Restrição legal
- Dados territoriais públicos.
- Limite técnico
- Os formatos de resposta da API de Malhas (GeoJSON/TopoJSON/SVG) NÃO foram reconfirmados em fonte oficial capturada nesta rodada — não são repetidos aqui como fato só porque constavam de levantamento anterior.
(campo volátil)Campo volátil: muda sem aviso e sem quebrar o link. Nenhum verificador de URL detecta. Confira na fonte oficial antes de depender dele.
O que esta fonte permite fazer
Resolver nomes e códigos territoriais, validar município e UF, construir hierarquias, obter geometria para join espacial e PADRONIZAR A CHAVE TERRITORIAL de DataJud, SICONFI, Comex, saneamento, saúde e educação. É a candidata natural à dimensão-território canônica do banco.
Cuidados para uso por IA
Nunca fazer join por NOME de município quando existe código oficial. Nunca normalizar acentos e usar isso como identidade. E nunca supor que geometrias de anos diferentes representam o mesmo recorte — a versão da malha precisa viajar junto.
Perguntas que esta base responde
- Qual o código IBGE deste município? — Alta
- Quais municípios pertencem a uma UF? — Alta
- Posso juntar duas bases pelo nome do município? — Não — use o código oficial
Apontadores
Endpoint técnico
https://servicodados.ibge.gov.br/api/docs/localidadesCanônico institucional
https://servicodados.ibge.gov.br/api/docs/localidadesCatálogo federado (dados.gov.br)
Busca ainda não realizada
Documentação
https://servicodados.ibge.gov.br/api/docs/malhasVerificação — 08/11/2026
Prova funcional em 08/11/2026: /api/v1/localidades/estados e /api/v1/localidades/municipios/5208707 devolveram 200 em application/json, e /api/v3/malhas/estados/53 devolveu 200 em application/vnd.geo+json. A pendência de conformidade sobre health-check em domínio do IBGE foi resolvida pela própria chamada.