Entendendo cidades e capitais do Brasil na prática
O IBGE mantém uma base atualizada com todos os municípios brasileiros e suas classificações, mas o problema é que nem todo mundo sabe onde encontrar os dados corretos ou como interpretar as categorias que eles usam. A distinção entre "capital" e "cidade sede de prefeitura" é mais complicada do que parece à primeira vista, porque o que define uma capital não é apenas o fato de abrigar o governo estadual, mas sim o código geográfico oficial atribuído pelo instituto.
cidades e capitais do brasil — o que realmente importa
Vou direto ao ponto: se você está montando um sistema que precisa lidar com cidades e capitais do brasil, o ideal é começar pela tabela de municípios do IBGE, disponível no site deles gratuitamente. O código numérico de cada município é a chave. Sem ele, você vai terminar com duplicatas, nomes errados e casos onde São Paulo e São Paulo (o estado) se confundem na base de dados. A URL direta para a base mais recente é o link para a tabela completa de códigos de municípios. Baixe o arquivo TXT ou XLSX e importe no seu banco. Não tente raspar a página, porque o IBGE atualiza os dados mensalmente e o layout muda sem aviso. Eu já perdi um dia inteiro tentando sincronizar com a versão errada da tabela em 2023 quando um município mudou de nome e o código permaneceu, mas a sigla do estado não correspondia mais ao que meu script esperava.
O workaround que eu uso agora é simples: faço um join pelo código do município e nunca pela sigla do estado ou pelo nome completo. O código é imutável. O nome pode mudar. A sigla pode ter abreviações diferentes em fontes distintas. Se alguém pedir a capital de Rondônia, por exemplo, o sistema precisa retornar Porto Velho, mas em várias bases externas esse nome aparece grafado de forma inconsistente. Com o código, esse problema desaparece.
pegadinhas que ninguém conta sobre capitais brasileiras
Aqui vai algo que os tutoriais básicos não mencionam: nem toda capital de estado é a cidade mais populosa do próprio estado. Isso quebra a suposição comum de que a capital sempre é o maior centro urbano. Belo Horizonte é a capital de Minas Gerais, mas a segunda cidade mais populosa do estado, e muitas bases de dados assumem erroneamente que a capital deveria ser automaticamente a maior. Brasília é capital de Goiás? Não. A capital de Goiás é Goiânia, e Brasília é a capital federal. Erros desse tipo aparecem com frequência em listas geradas automaticamente por API de terceiros. Outra coisa: o Distrito Federal não é um estado, mas funciona como capital federal. Isso significa que há uma categoria extra que a maioria dos formulários e validações ignora. Se seu sistema pede "estado" e o usuário seleciona "DF", ele precisa tratar isso de forma diferente. Muitos desenvolvedores tratam o DF como estado e depois descobrem que a validação falha porque o código do IBGE para o DF é 53, enquanto o de um estado normal começa com outro dígito.
👉 Clique no botão abaixo para saber mais sobre o assunto!
como estruturar isso no banco de dados
Crie uma tabela de estados com id, nome e sigla. Crie uma tabela de municípios com código_ibge, nome, nome_popular (o nome que as pessoas realmente usam no dia a dia), e estado_id como chave estrangeira. Adicione uma flag booleana ou um campo de tipo que identifique a capital. Não use um nome de coluna genérico como "is_capital" — prefira algo mais descritivo como "tipo_municipio" com valores como "capital_estadual", "capital_federal", "municipio_normal". Isso evita confusão quando você precisar adicionar o DF ou qualquer caso especial no futuro. Eu recomendo também manter uma coluna com a latitude e longitude da sede municipal. O IBGE fornece essas coordenadas no mesmo arquivo de dados. Sem elas, você vai depender de APIs externas de geocodificação, que são lentas, têm limite de requisições e podem retornar resultados inconsistentes. O preço disso é que você precisa atualizar a base de vez em quando quando o IBGE lança uma atualização com correções geográficas.
ferramenta que eu uso no dia a dia
Existe um pacote Python chamado `brasilio` que já traz a tabela de cidades e capitais do brasil pronta, com os dados do IBGE organizados e atualizados. A instalação é simples — roda `pip install brasilio` — e ele expõe funções como `get_all_cities()` e `get_states()`. O problema é que a manutenção dele depende de contribuidores voluntários, então às vezes as atualizações do IBGE demoram para aparecer no pacote. Quando isso acontece, eu faço o download manual e rodopuro um script de importação SQL, que leva cerca de 3 minutos para processar os 5.570 municípios atuais. Se você está no JavaScript ou TypeScript, o `ibge-cities-js` é uma alternativa similar. Ele exporta os dados como um objeto JSON que você pode importar diretamente no projeto. O tamanho do arquivo é cerca de 2 MB, o que pode ser pesado para aplicações móveis, mas para back-end ou desktop não faz diferença significativa.
quando isso tudo falha
Se você precisa de dados em tempo real — por exemplo, mostrar qual cidade tem a maior população hoje — esses pacotes e arquivos estáticos não servem. O IBGE publica estimativas anuais de população, mas não dados diários. Para casos assim, a única saída é integrar com APIs como a do DataSUS ou do próprio IBGE via web service, que são mais lentos e têm instabilidade ocasional. Eu já vi sistemas inteiros de entrega caírem porque a API de referência de população estava fora do ar durante uma promoção de e-commerce que dependia dela para calcular frete por região. A melhor estratégia é ter cache local com data de validade. Armazene os dados, marque quando foram atualizados, e se a data tiver mais de 12 meses, force uma nova busca. Isso evita que seu sistema funcione com dados desatualizados sem que o usuário perceba.
Uma última observação prática: se seu público-alvo inclui populações de comunidades indígenas ou quilombolas, os nomes oficiais das cidades podem não refletir a forma como essas comunidades se referem aos lugares. Dados oficiais e dados vividos são coisas diferentes. Mapear essa divergência exige trabalho de campo ou parcerias com fontes locais, algo que nenhum pacote pip ou npm resolve sozinho.
