Como organizar e consultar os municípios do estado de São Paulo no dia a dia
A maior parte das pessoas que precisa trabalhar com dados geográficos ou administrativos do estado de São Paulo começa procurando uma lista pronta. O problema é que, dependendo do que você vai fazer com esses dados, uma simples planilha copiada da Wikipédia já vira dor de cabeça em duas horas. Eu perdi esse tempo no início e agora prefiro ir direto para as fontes oficiais e montar o próprio arquivo do zero.
municípios do estado de são paulo
O estado tem 645 municípios segundo o Censo 2022 do IBGE. Esse número não é fixo. Já houve tempos em que eram 644, 643, e isso se deve a emancipações políticoadministrativas que acontecem periodicamente, geralmente impulsionadas por leis estaduais. Se você está usando dados de uma fonte que não tem data de atualização, pode estar trabalhando com números desatualizados sem perceber. Para um trabalho sério, o arquivo que eu sempre baixo é o de divisões municipais do IBGE, disponível no site deles na seção de malhas e dados territoriais. O formato é SHAPE ou GeoJSON, e o arquivo vem com código IBGE, nome, região imediata e microrregião. O código IBGE é uma coisa que você precisa manter colado: é o identificador padrão para cruzar dados do SIDRA, do DATASUS, do CNES, do CAGED, praticamente toda base governamental que exige identificação municipal.
Aqui vai algo que quem nunca montou um banco de dados geográfico não desconfia. O nome do município não é campo confiável para join. Tem cidade que se chama mesmo que outra, tem variação de acentuação entre tabelas, tem município que mudou de nome e a versão antiga continua aparecendo em dados históricos. Eu já passei três horas tentando entender por que meu script não caseava dados de 2018 com a base atual porque um município tinha sido renomeado e o código IBGE era a única coisa que permanecia invariável. Outro detalhe prático. O estado de São Paulo está dividido em 21 regiões administrativas da Secretaria da Fazenda, mas essa divisão não tem relação direta com a divisão do IBGE em microrregiões e regiões metropolitanas. Se você está fazendo análise fiscal ou orçamentária, usa a divisão da Sefaz. Se está fazendo epidemiologia ou planejamento urbano, a divisão do IBGE é mais adequada. Misturar as duas sem criterio resulta em agregação errada, e o erro é silencioso, ninguém percebe até o relatório final sair com números estranhos.
Quando eu precisei fazer uma análise de densidade demográfica cruzada com informações de saúde, meu problema foi que alguns municípios tinham sido criados depois da data de referência dos dados do SUS. A solução foi manter o código IBGE vigente na época do dado e fazer um mapeamento backward usando um arquivo de histórico de alterações municipaes que o IBGE publica ocasionalmente. Não é bonito, mas resolve. O arquivo de histórico fica nos documentos técnicos do IBGE junto com as notas metodológicas do Censo.
Passo a passo para montar sua base
Baixe o arquivo de divisões municipais mais recente no site do IBGE. O nome costuma ser algo como DIVMUNI ou similar. Extraia o shape ou o GeoJSON. Importe para o banco ou para o Python usando geopandas se for trabalhar com código. Faça join pelo campo code_muni ou equivalência conforme o formato do arquivo. Se for usar R, o pacote ibgefix ou o geoibdge resoltem boa parte da conversão, mas verifique sempre a versão. Package atualizado para 2022 pode ainda não refletir emancipações do início de 2023. Eu já caí nessa armadilha duas vezes.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Para quem trabalha com Excel, existe a tabela simplificada com código IBGE, nome e região metropolitana que o IBGE disponibiliza em formato XLSX. É útil para consultas rápidas, mas não serve para análise espacial. O arquivo virá sem coordenadas, sem polígonos, só os atributos tabulares. Use essa opção quando não precisar de GIS.
Erros comuns e como evitar
Não confie em listas de terceiros sem verificar a data. Planilhas compartilhadas em fóruns e grupos às vezes circulam há anos sem atualização. Um município emancipado aparece como inexistente, e você gasta tempo debugando dados que simplesmente não existem na base. Não use abreviações de município para identificação. SP, RJ, MG são siglas estaduais, mas dentro de São Paulo existem cidades cujos nomes abreviados se sobrepõem. Código IBGE resolve isso.
Não ignore a questão das regiões metropolitanas. São Paulo tem oito regiões metropolitanas oficiais mais a RIDE Metropolitana de São Paulo, que é uma divisão diferente do IBGE. Se você precisa agregar dados por RM, baixe a definição oficial da Secretaria de Desenvolvimento Econômico ou do IBGE. Definições alternativas da mídia ou de consultorias costumam divergir no limiar de inclusão de municípios periféricos. Se o seu trabalho envolve orçamento público, lembre-se que a Lei de Responsabilidade Fiscal exige a utilização dos códigos IBGE vigentes. Dados desatualizados podem gerar inconsistência na prestação de contas e, em alguns casos, rejeição de contas por parte dos tribunais de conta.
Quando a coisa complica
Municípios com área de transição entre regiões administrativas podem aparecer duplicados em bases que não tratam sobreposições. Isso é raro, mas acontece em municípios que sofreram divisão de território recente. Verifique a topologia do shape depois de importar. Um PolyGonInvalidError ou geometria sobreposta indica problema na fonte. Também é comum encontrar dados em que o município foi incorporado temporariamente ou teve sua sede transferida entre distritos. Nesses casos, o código IBGE permanece, mas a localização geográfica muda. Para análise temporal longa, acompanhe também as alterações de sede, não apenas os códigos.
Se você precisa apenas de uma lista simples para consulta rápida e não vai processar os dados programaticamente, a tabela consolidada do IBGE com os 645 municípios, código, nome, população estimada e região metropolitana é suficiente. Baixe, salve, e não perca tempo com shapefiles desnecessários. O link direto para os dados territoriais do IBGE é https://www.ibge.gov.br/geociencias/organizacao-do-territorio/malhas-territoriais.html . Lá você encontra o pacote completo com divisões municipais, regiões imediatamente e microrregiões, tudo sincronizado com a data-base mais recente do Censo.
