Entendendo as cidades do estado de Goiás: o que você realmente precisa saber antes de trabalhar com elas
Goiás tem 246 municípios registrados na TSE, mas na prática o número muda porque alguns ganham e perdem status todo ano durante os pleitos eleitorais. Eu lido com isso há anos, principalmente na parte de cadastro territorial e integração com sistemas governamentais, então vou direto ao ponto. O IBGE mantém a base oficial atualizada em dezembro de cada ano. A última versão estável traz códigos numéricos de seis dígitos para cada município, e esses códigos são o que você deve usar em qualquer sistema sério. O problema é que muita gente ainda tenta importar planilhas de portais de transparência que usam nomenclaturas antigas ou abreviações inconsistentes. Já vi gente perdendo dias porque o sistema deles não tolerava "Anápolis" escrito de formas diferentes em tabelas distintas.
como organizar e consultar as cidades do estado de goias de forma prática
A forma mais simples e confiável é baixar o arquivo do IBGE. Eles disponibilizam CSV, SHP e JSON. O JSON é útil se você vai consumir via API, mas o CSV funciona para 90% dos casos. Basta ir em dados.abnt.com.br, procurar por "municípios", selecionar Goiás, e baixar. O arquivo vem com código IBGE, nome, microrregião, mesorregião e população estimada. Um detalhe que poucos notam: o IBGE atualiza a população estimada em setembro, mas o nome e a codificação só mudam em janeiro após a reorganização administrativa. Se você está rodando um processo automático todo mês, programe a atualização completa apenas em janeiro. Nas demais semanas, use apenas a coluna de população, senão vai receber falsos positivos de mudança de município.
Eu precisei resolver isso num projeto de integração fiscal onde os arquivos de NFS-e vinham de prefeituras com campos de código municipal desalinhados. Um lotador tinha colocado o código de Aparecida de Goiânia como 5201108 em vez do correto, 5201100. Isso quebrou toda a validação cruzada. A solução foi criar um dicionário próprio com os códigos corretos do IBGE e usar correspondência fuzzy pelo nome como fallback quando o código não batia. Funcionou, mas levou dois dias só para testar a abrangência. Outra armadilha comum são os municípios criados após o corte demográfico do IBGE. Nova Iguaçu da Bahia foi desmembrado de uma cidade vizinha, e o código novo não aparece em bases antigas de qualquer órgão federal até doze meses depois. Se o seu sistema exige código IBGE válido para todas as cidades cadastradas, você vai ter municípios órfãos que não resolvem nem com busca por nome. Nesse caso, o workaround é manter uma coluna de "código provisório" baseado no ano de criação, mas isso só funciona se você estiver lidando com fontes oficiais.
Para quem trabalha com geolocalização ou mapeamento, o Shapefile do IBGE é mais confiável que o GeoJSON porque os polígonos vêm com topologia validada. Já tentei converter Shape para GeoJSON e o resultado tinha buracos nos municípios da mesorregião do Vale do Rio Paranaíba. A conversão com a ferramenta do próprio QGIS, usando o comando de reparo de geometria, resolveu, mas tome cuidado com a projeção. Use sempre o EPSG:4617 (SIRGAS 2000) para dados internos do Brasil. Qualquer outra coisa gera discrepância de centenas de metros nos limites municipais. Se o seu objetivo é apenas consultar, uma boa alternativa ao download manual é usar a API do IBGE Dados, que é gratuita e não precisa de autenticação. Você pode fazer consultas como /dados/municipios?ids=52&atributos=nome,codmun,area, populacaoprog, mas o rate limit é rigoroso: vinte requisições por minuto. Se você precisa bater em todos os 246 municípios de uma vez, faça em lotes de cinquenta e espere entre cada chamada.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Quais são os municípios mais relevantes para quem trabalha com dados de Goiás
Do ponto de vista operacional, apenas uma dezena de cidades concentra a maior parte do fluxo de dados. Anápolis, Aparecida de Goiânia, Goiânia, Senador Canedo e Rio Verde respondem por cerca de sessenta por cento das movimentações fiscais e eleitorais do estado. O resto é ruído em grande escala. Anápolis, código 5200308, é o segundo maior em PIB industrial e tem a particularidade de ser cortada pela BR-060 e pela GO-060, o que gera sobreposição de jurisdição em fiscalização rodoviária. Quando você monta uma tabela de incidência tributária, precisa tratar essa sobreposição separadamente, senão os valores duplicam.
Aparecida de Goiânia, 5201100, é um caso à parte porque cresceu tanto que o IBGE mudou sua classificação de município para região metropolitana, mas oficialmente continua como município autônomo. Isso causa confusão em sistemas que cruzam dados do Datasus com do IBGE, porque um campo usa a classificação metropolitana e outro não. Goianira, 5208756, é um exemplo de município pequeno que cresceu rápido nas últimas décadas e hoje tem infraestrutura de dados muito melhor que cidades maiores ao redor. Se você precisa de amostra para testar integrações sem lidar com a complexidade de Goiânia, use Goianira. Os dados são completos e as APIs municipais estão estáveis.
Ti mesmo tempo, municípios como Porangatu, 5217102, ou Uruaçu, 5222400, ainda têm portais de transparência com formato irregular. Os arquivos PDF não são buscáveis e os dados tabulares vêm em planilhas desatualizadas. Se o seu projeto depende dessas cidades, planeje um tempo extra de duas a três semanas para limpeza manual dos dados.
O que não funciona e o que evitar
Não confie em bases de terceiros que prometem atualização automática dos municípios de Goiás. Já vi dois casos em que um provedor comercial manteve os códigos antigos de 2021 enquanto o IBGE havia atualizado em 2023. O erro mais frequente é a falta de sincronia entre a tabela de códigos e a tabela de nomes. Quando o IBGE renomeia um município, como aconteceu com "Nova Roma" que teve seu nome retificado, a base comercial mantém o nome antigo e o código novo, gerando inconsistência. Também evite usar listas manuais de municípios feitas por qualquer pessoa fora do IBGE ou do TSE. Eu já encontrei listas com dezoito cidades faltando e duas duplicadas em documentos que pareciam confiáveis. A única fonte verdadeiramente atualizada é o site do IBGE, seguido pelo cadastro nacional de pessoas jurídicas da Receita Federal, que cruza os códigos com CNPJ ativos.
Se você está montando um sistema do zero e precisa de uma base rápida para desenvolvimento, use o dump mensal do OpenCNPJ. Ele traz todos os municípios com seus códigos atuais e já vem limpo, mas atenção: o OpenCNPJ tem dados até o último dia útil do mês anterior. Se você for produção hoje, os dados podem estar com um mês de defasagem em relação à realidade.
