localdatasus

Pacote R
Saúde
Pacote R para baixar dados de saúde do SUS por bairro, com população, taxas e coordenadas.
Data de Publicação

1 de outubro de 2026

O microdatasus traz os dados do SUS por município. O localdatasus desce ao bairro. Ele junta quatro tipos de fonte:

Cada bairro é ligado ao bairro oficial do IBGE, com população do Censo 2022, taxa por 10 mil habitantes e coordenadas.

library(localdatasus)

obitos_bairro("Rio de Janeiro", 2023, cid = "I")       # óbitos por doenças circulatórias
agravos_bairro("dengue", "Joinville", 2024)            # casos de dengue
obitos_bairro("Fortaleza", 2023)                       # TabNet de Fortaleza
estabelecimentos_bairro("Recife", tipo = "hospital")   # CNES, qualquer município
mapa_bairro(obitos_bairro("São Paulo", 2023))          # mapa pronto

Mapas por bairro

Cada tabela vira um mapa com uma linha, mapa_bairro(), sobre os contornos oficiais de bairros e distritos do IBGE. Taxas por 10 mil habitantes:

Rio de Janeiro: óbitos por doenças circulatórias, 2023

São Paulo: óbitos por doenças circulatórias, 2023, por distrito

Fortaleza: nascidos vivos, 2023

Recife: dengue, casos notificados, 2024 (taxa suavizada)

Curitiba: atendimentos por doenças respiratórias, jun. a ago. 2026

Recife: chamados do SAMU por causas externas, 2024 (número de chamados, pelo local da ocorrência)

Instalar

Versão atual: 0.2.0, com novidades em desenvolvimento no GitHub (0.2.0.9000)

install.packages("remotes")
remotes::install_github("Hendesson/localdatasus")

Documentação e tutoriais Código no GitHub Relatar um problema Tirar uma dúvida

Como citar

Alves, Hendesson (2026). localdatasus: dados de saúde do SUS por bairro. Pacote R, versão 0.2.0.9000. https://doi.org/10.5281/zenodo.23244742

No R: citation("localdatasus").

Novidades

localdatasus (em desenvolvimento)

Mudanças feitas depois do envio da versão 0.2.0 ao CRAN.

  • Nova função suavizar_taxas() e argumento suavizar = TRUE em mapa_bairro() e mapa_interativo(): taxa suavizada pelo estimador bayesiano empírico de Marshall (1991), por município, ano e categoria, para bairros com poucos moradores, a partir de uma observação sobre o mapa do Recife.
  • samu_bairro(): a documentação avisa que a taxa por morador engana em áreas centrais e hospitalares; para mapas, use valor = "chamados".
  • Correção: tabelas de TabNet guardadas no cache por versões antigas do pacote (com a coluna coluna no lugar de categoria) são convertidas ao serem lidas, em vez de dar erro.
  • Citação com o DOI do Zenodo (10.5281/zenodo.23244742), que vale para todas as versões; citation("localdatasus") traz também o ORCID do autor.
  • Documentação em https://hendesson.github.io/localdatasus/ (pkgdown), com a referência das funções por tema, os tutoriais como artigos e uma galeria de mapas no README.

localdatasus 0.2.0

  • Correção: a padronização de nomes e rótulos tirava os acentos de forma diferente no macOS (“Etária” virava “Et’aria”), o que podia impedir a escolha de opções nos TabNets. Agora o resultado é o mesmo em Linux, macOS e Windows.
  • Preparação para o CRAN: o ‘microdatasus’ passa a vir do CRAN (sai o campo Remotes); ORCID do autor; exemplos que baixam dados usam @examplesIf interactive(); ajuda() devolve um objeto com método print(); os testes não usam a internet nem o cache do usuário; nova vinheta “Primeiros passos”; guia de contribuição e checagem automática no GitHub Actions (Linux, macOS e Windows).
  • Nova fonte: TabNet da Secretaria Municipal de Saúde de Fortaleza (FOR-SIM e FOR-SINASC), com óbitos e nascidos vivos por bairro de residência desde 1999. obitos_bairro("Fortaleza", ...) e nascimentos_bairro("Fortaleza", ...) passam a usá-la.
  • Nova função samu_bairro(): chamados do SAMU 192 do Recife e região metropolitana por bairro do local da ocorrência (dados abertos da Prefeitura do Recife, 2016 em diante), com filtro por tipo de ocorrência e aberturas por subtipo, sexo, origem do chamado e desfecho.
  • Nova função estabelecimentos_bairro(): estabelecimentos de saúde ativos do CNES (Portal de Dados Abertos do SUS) por bairro, em qualquer município, com filtro por tipo de unidade (descrições da API de Dados Abertos do Ministério da Saúde) e opção de contar só os que atendem pelo SUS.
  • Nova função atendimentos_bairro(): atendimentos médicos da rede municipal de Curitiba (Sistema e-Saúde, dados abertos, 2019 em diante) por bairro de residência do paciente, com filtro por CID e aberturas por sexo, faixa etária, tipo de unidade, profissional e internamento. Os meses baixados ficam no cache.
  • Nova fonte: arboviroses da Prefeitura do Recife (DENGUE-RECIFE, CHIKUNGUNYA-RECIFE, ZIKA-RECIFE), registros individuais de 2013 em diante com CEP e nome do bairro. agravos_bairro("dengue", "Recife", ...) passa a usá-las; por = "classificacao" separa confirmados e descartados.
  • Tabela CEP → bairro: endereços do CNEFE em setores sem bairro oficial passam a receber o bairro oficial quando o nome da localidade é o mesmo (em Recife, os endereços sem bairro oficial caíram de 13,6% para 0,4%; no Rio, de 2,3% para 0,3%). O cache é refeito automaticamente (cep_bairro_v3).
  • agregar_bairro() e as funções simples usam a população dos bairros da UF certa (antes, só do RJ).
  • A ligação aproximada de nomes ignora os espaços (“Bom Sucesso” liga a “Bonsucesso”).
  • Fontes que só filtram por capítulo da CID dão um erro claro (LDS-09) quando recebem códigos de 3 caracteres.
  • Correção: consultas a fontes estaduais sem registros no município pedido davam erro interno; agora dão LDS-12.

localdatasus 0.1.0

Primeira versão pública.

  • Funções simples: onde_tem_bairro(), obitos_bairro(), nascimentos_bairro(), agravos_bairro() e internacoes_bairro().
  • Mapas: mapa_bairro() (ggplot2) e mapa_interativo() (leaflet), com contornos de bairros e distritos do Censo 2022.
  • Erros e avisos com código (LDS-01 a LDS-23) e ajuda().
  • Microdados com CEP (SIH, APACs, SINASC-RJ) localizados por bairro pelo CNEFE 2022.
  • TabNets regionais com bairro: Prefeitura do Rio, SES-RJ, Prefeitura de São Paulo (distritos) e DIVE-SC.
  • Exemplos comentados em exemplos/.

O que dá para fazer

Função O que faz
onde_tem_bairro() lista os dados que existem, onde e para quais anos
obitos_bairro() óbitos por bairro, causa (CID) e ano
nascimentos_bairro() nascidos vivos por bairro
agravos_bairro() dengue, tuberculose, sífilis, violência…
internacoes_bairro() internações do SUS, pelo CEP do paciente
atendimentos_bairro() atendimentos médicos da rede municipal de Curitiba (e-Saúde), com CID
samu_bairro() chamados do SAMU 192 do Recife e região metropolitana, pelo local da ocorrência
estabelecimentos_bairro() estabelecimentos de saúde (CNES) por bairro, em qualquer município
mapa_bairro(), mapa_interativo() mapas estáticos e interativos
ajuda() explica cada código de erro
De volta ao topo