Primeiros passos com o localdatasus

O localdatasus traz dados de saúde do SUS por bairro, com população do Censo 2022, taxa por 10 mil habitantes, coordenadas e mapas. Todas as funções seguem a mesma ideia: você diz o quê, onde e quando, e o pacote escolhe a fonte.

O que existe e onde

Nem todo lugar tem dados por bairro. Comece perguntando ao pacote:

library(localdatasus)
head(onde_tem_bairro()[, c("dado", "local", "funcao")])
#>          dado                    local           funcao
#> 1 chikungunya         Recife (capital) agravos_bairro()
#> 2      dengue         Recife (capital) agravos_bairro()
#> 3        zika         Recife (capital) agravos_bairro()
#> 4        aids Rio de Janeiro (capital) agravos_bairro()
#> 5 chikungunya Rio de Janeiro (capital) agravos_bairro()
#> 6      dengue Rio de Janeiro (capital) agravos_bairro()

Óbitos, nascimentos e agravos

# Óbitos por doenças do aparelho circulatório (capítulo IX da CID-10)
circ <- obitos_bairro("Rio de Janeiro", 2023, cid = "I")

# Abertura por sexo
obitos_bairro("Rio de Janeiro", 2023, cid = c("I", "J"), por = "sexo")

nascimentos_bairro("Fortaleza", 2023)
agravos_bairro("dengue", "Recife", 2024, por = "classificacao")

Cada linha da tabela é um bairro, com o nome oficial do IBGE (bairro), o nome na fonte (bairro_no_site), a contagem, a populacao, a taxa_por_10mil, as coordenadas (lat, lon) e a etapa de ligação ao IBGE (ligacao).

Internações, em qualquer estado

As internações chegam ao bairro pelo CEP do paciente, cruzado com o Cadastro Nacional de Endereços para Fins Estatísticos (CNEFE) do Censo 2022:

pe <- internacoes_bairro("Recife", 2023, cid = "I", uf = "PE")
attr(pe, "cobertura")   # quantas ganharam bairro, e por que as outras não

Outras bases

atendimentos_bairro("Curitiba", 2025, meses = 1:3, cid = "J")   # e-Saúde de Curitiba
samu_bairro("Recife", 2024, tipo = "causas externas")             # local da ocorrência
estabelecimentos_bairro("Recife", tipo = "unidade basica")        # CNES, qualquer município

Mapas

mapa_bairro(circ)        # mapa estático (ggplot2)
mapa_interativo(circ)    # mapa interativo (leaflet)

Quando algo dá errado

Cada erro traz um código. A função ajuda() explica a causa e sugere a solução:

ajuda("LDS-05")
#> 
#> LDS-05 — Não há dado por bairro para esse lugar
#> 
#>   O que aconteceu:
#>     Só algumas secretarias publicam dados por bairro. Para esse lugar e
#>     esse tipo de dado, não há fonte pública conhecida.
#> 
#>   Como resolver:
#>     Veja o que existe com onde_tem_bairro(). Para internações, use
#>     internacoes_bairro(), que funciona em todas as UFs (pelo CEP).

Tutoriais completos: https://hendesson.github.io/tutoriais.html.