1 Introdução ao VIGIAR e ao pacote vigiar
1.1 O Sistema VIGIAR
O VIGIAR (Vigilância em Saúde Ambiental) é um programa do Ministério da Saúde do Brasil que integra dados ambientais e de saúde para monitorar os impactos da poluição do ar na saúde da população brasileira.
O dashboard público do VIGIAR está disponível no Power BI:
1.1.1 Dados disponíveis
O dashboard consolida dados de múltiplas fontes:
1.1.1.1 Qualidade do Ar (PM2.5)
- Médias anuais e mensais de PM2.5 por município brasileiro
- Dias críticos (acima dos limites OMS e CONAMA)
- Coordenadas geográficas (latitude/longitude)
- Categorização por faixas de concentração
1.1.1.2 População Exposta
- População residente por município e ano
- Categorias de exposição à poluição do ar
- Dados do IBGE (censos e projeções)
1.1.1.3 Indicadores de Saúde
- Mortalidade por doenças respiratórias e cardiovasculares
- Internações hospitalares (SIH)
- Anos de vida perdidos (YLL)
- Indicadores agregados por Brasil, UF e município
- Fração atribuível à poluição do ar
1.1.1.4 Exposição Indoor
- População exposta a combustíveis sólidos em domicílios
- Desfechos de saúde associados
- Dados desagregados por sexo e estado
1.2 Por que o pacote vigiar?
O dashboard do VIGIAR é interativo e visual, mas para pesquisa científica e análise de dados, baixar os dados manualmente é:
- Demorado: são 14+ tabelas com milhares de registros
- Não reprodutível: cada download manual pode gerar resultados diferentes
- Propenso a erros: copiar/colar ou exportar manualmente introduz erros
- Não auditável: sem registro de quando e como os dados foram obtidos
O pacote vigiar resolve esses problemas implementando o acesso programático à API interna do Power BI, garantindo:
- Automação completa: downloads em lote com uma linha de código
- Reprodutibilidade: snapshots com SHA256, schema locking, logging
- Validação integrada: verificação de códigos IBGE, datas, unidades
- Diagnóstico automático: detecção de quebras de série, duplicatas, valores suspeitos
- Auditoria multi-perfil: conformidade com padrões rigorosos de qualidade de dados
1.3 Arquitetura do pacote
O pacote implementa o protocolo de API do Power BI “Publish to Web”:
Usuário → vigiar_conectar() → Power BI Page → cookies + session
↓
vigiar_baixar("tabela")
↓
.vigiar_construir_query() → monta JSON Semantic Query
↓
.vigiar_executar_query() → POST /querydata
↓
.vigiar_parse_dados() → decodifica DSR → data.frame
1.3.1 Módulos principais
| Módulo | Arquivo(s) | Função |
|---|---|---|
| Conexão |
conexao.R, client.R
|
Sessão Power BI, cookies, retry |
| API | api.R |
Construção e execução de queries |
| Download |
download.R, rj.R
|
Download, filtro UF/RJ, catálogo |
| Parse | parse.R |
Decodificação DSR → data.frame |
| Processamento | process.R |
Padronização e tipagem S3 |
| Validação | validar.R |
IBGE, datas, unidades, RJ |
| Diagnóstico | diagnostic.R |
Qualidade de séries temporais |
| Auditoria |
compliance.R, auditar.R
|
SHA256, multi-perfil |
| Cache | cache.R |
Cache local, snapshots, schema lock |
| Logging | log.R |
Log estruturado INFO/WARN/ERROR |
| Classes | classes.R |
S3: vigiar_tbl, print, summary |
| Dicionário | dictionary.R |
Documentação de variáveis |
| Ciclo de vida | lifecycle.R |
Registro de estabilidade da API pública |
| Séries | series.R |
Agregação temporal, tendências |
| Exportação | exportar.R |
CSV, RDS, Parquet, JSON |
| Resumo | resumo.R |
Resumos estatísticos por domínio |
1.3.2 Filosofia: desconfie dos dados
O pacote vigiar adota uma postura de ceticismo saudável em relação aos dados:
“O vigiar desconfia dos dados antes de seduzir o pesquisador com gráficos.”
Por isso, toda operação de download é acompanhada de validação, e o pipeline de diagnóstico é executado antes de qualquer análise.
1.4 Limitações metodológicas
Esta seção concentra as limitações do pacote para evitar que sejam reafirmadas com redações diferentes em outros capítulos.
-
Limite de linhas da API (~30 mil): a API do Power BI usada pelo VIGIAR trunca respostas em aproximadamente 30 mil linhas. Para tabelas maiores, use
vigiar_baixar_rj()(download particionado ASC+DESC) ou filtre por ano e UF. -
Schema instável: o dashboard pode mudar sem aviso. Use
vigiar_esquema_lock()para congelar evigiar_status()para verificar. - Dependência externa: o pacote depende do portal Power BI do Ministério da Saúde. Se o portal sair do ar, o download falha.
- Dados secundários: o pacote baixa dados públicos, não os gera. Validação é obrigatória antes de qualquer análise.
1.5 Pré-requisitos
- R ≥ 4.1.0
- Conexão com a Internet (para download dos dados)
- Pacotes:
httr2,jsonlite,tibble,dplyr,cli,openssl - Opcionais:
arrow(para Parquet),knitr/rmarkdown(para vignettes),ggplot2(para visualização)