Skip to contents

Monta, a partir do CNEFE 2022 (todos os endereços do Censo), a ligação entre cada CEP e o bairro onde estão seus endereços.

Usage

cep_bairro(uf, manter_cnefe = FALSE)

Arguments

uf

Sigla da UF, por exemplo `"RJ"`.

manter_cnefe

Se `TRUE`, mantém o arquivo do CNEFE no cache depois de processado (ocupa espaço). Padrão: `FALSE`.

Value

Uma lista com dois `data.frame`s:

ceps

`cep`, `codmun_cep`, `id_bairro`, `pct_bairro` (fração dos endereços do CEP que está nesse bairro), `n_end_cep` (nº de endereços do CEP) e `lat_cep`, `lon_cep` (mediana das coordenadas dos endereços do CEP).

bairros

`id_bairro`, `codmun`, `bairro`, `fonte_bairro`, `cd_bairro_ibge`, `lat_bairro`, `lon_bairro` (mediana das coordenadas dos endereços do bairro) e `n_enderecos`.

Details

O bairro de cada endereço vem do bairro OFICIAL do IBGE (pelo setor censitário), quando o município tem bairros oficiais; senão, da localidade informada no próprio endereço do CNEFE. Cada CEP recebe o bairro onde está a MAIORIA dos seus endereços.

Na primeira vez baixa o CNEFE da UF (de ~10 MB no AC a ~1 GB em SP) e guarda só a tabela resultante no cache; as próximas chamadas são instantâneas.

References

Instituto Brasileiro de Geografia e Estatística. Coordenadas geográficas dos endereços no Censo Demográfico 2022: nota metodológica n. 01. Rio de Janeiro: IBGE; 2024.

Empresa Brasileira de Correios e Telégrafos. Endereçamento de correspondências: guia técnico. Versão 1.4. Brasília: Correios; 2021. (Estrutura do CEP e sufixos especiais.)

Abordagem relacionada, com serviços de geocodificação: Rocha TAH, Silva NC, Amaral PVM et al. Geolocalização de internações cadastradas no Sistema de Informações Hospitalares do Sistema Único de Saúde: uma solução baseada no programa estatístico R. Epidemiologia e Serviços de Saúde 2018; 27(4):e2017444. doi:10.5123/s1679-49742018000400016 .

Examples

if (FALSE) { # interactive()
tab <- cep_bairro("AC")
head(tab$ceps)
}