Baixa de um TabNet de secretaria estadual ou municipal (ver [fontes_tabnet()]) as contagens por bairro (ou distrito) de residência, ano a ano, e liga cada bairro ao bairro do IBGE (código, coordenadas e população) com [ligar_bairros()].
Usage
tabnet_bairro(
fonte,
anos,
coluna = NULL,
filtros = list(),
incremento = NULL,
municipios = NULL,
ligar = TRUE
)Arguments
- fonte
Código da fonte (ver [fontes_tabnet()]) ou uma linha no mesmo formato, para usar um TabNet que ainda não está no cadastro.
- anos
Anos (de notificação, óbito ou nascimento, conforme a base).
- coluna
Rótulo de uma variável para abrir as contagens (ex.: `"Sexo"`, `"Faixa Etária"`); veja `tabnet_opcoes(fonte, "colunas")`. `NULL` = só o total por bairro.
- filtros
Lista nomeada: nome do filtro = rótulo(s) das opções aceitas, por exemplo `list("Causa (Cap CID10)" = c("IX", "X"))`. O rótulo pode ser só o começo do texto. Veja `tabnet_opcoes(fonte, "filtros")`.
- incremento
O que contar, quando a fonte oferece mais de uma medida; veja `tabnet_opcoes(fonte, "incrementos")`.
- municipios
Códigos de município (6 dígitos) a consultar, nas fontes estaduais. `NULL` = todos os que têm registros.
- ligar
Se `TRUE`, liga os nomes aos bairros/distritos do IBGE.
Value
Um `data.frame` com `fonte`, `ano`, `codmun`, `municipio`, `bairro_tabnet` (como veio do site), `categoria` (valor de `coluna`), `n` e, com `ligar = TRUE`, as colunas de [ligar_bairros()] (`ligacao`, `id_unidade`, `nome_ibge`, `cd_ibge`, `lat`, `lon`, `populacao`) e `taxa_10mil` (por ano, sobre a população de 2022).
Details
São dados AGREGADOS: não há registro individual nem CEP. Cada consulta cruza só duas variáveis (bairro x `coluna`); para mais dimensões, use `filtros` e repita a chamada. As consultas ficam em cache.
Nas fontes estaduais em que o rótulo do bairro não diz o município (como a DIVE-SC), é feita uma consulta por município: primeiro descobre quais municípios têm registros no ano, depois consulta cada um. Use `municipios` para limitar.
Examples
if (FALSE) { # interactive()
# Óbitos por doenças do aparelho circulatório, por bairro do Rio
tabnet_bairro("RIO-SIM", 2022:2023, coluna = "Faixa Etária",
filtros = list("Causa (Cap CID10)" = "IX"))
# Dengue por bairro em Joinville (SC)
tabnet_bairro("SC-SINAN-DENGUE", 2024, municipios = "420910")
# Óbitos por distrito da cidade de São Paulo
tabnet_bairro("SP-SIM", 2023, coluna = "Sexo")
}