README.md
In precviasBR: Spatial Data of Road Precariousness in Brazil

precviasBR

O precviasBR é uma ferramenta de engenharia de dados espaciais para acesso facilitado a indicadores de precariedade viária em todo o território brasileiro. O pacote integra a malha de transportes do Overture Maps com os dados de entorno do Censo Demográfico 2022 (IBGE).

Trabalhar com dados de entorno do Censo e malhas viárias nacionais exige alto poder de processamento e manejo de arquivos pesados. O precviasBR automatiza:

Download segmentado por UF via Zenodo.
Armazenamento em cache local.
Leitura ultra-rápida via Apache Arrow (sem carregar tudo na RAM).
Possibilidade de baixar os dados no Zenodo (Malha Espacial de Precariedade Viária Brasileira (Censo 2022 + Overture Maps)) e rodar localmente.

Nota: dados de entorno são informações coletadas por observação direta dos recenseadores do IBGE. Eles caracterizam a infraestrutura urbana do logradouro (o espaço público) de forma independente das respostas dos moradores.

Você pode instalar a versão de desenvolvimento diretamente do Codeberg usando:

# install.packages("remotes")
remotes::install_git("https://codeberg.org/precvias-project/precviasBR-package.git")

library(precviasBR)
library(dplyr)

# Carregar dados de um município específico (ex: Porto Alegre)
dados_poa <- read_precvias(code_muni = 4314902) |> 
  collect() # Traz para a memória do R como um tibble/sf

| Variável | Descrição | |------------------|-----------------------------------------------------------------| | total_domicilios | Total de domicílios no setor censitário correspondente | | pop_total | População total residente no setor | | prop_pav | Proporção de domicílios com pavimentação na via | | prop_calcada | Proporção de domicílios com calçada | | prop_ilum | Proporção de domicílios com iluminação pública | | prop_bueiro | Proporção de domicílios com bueiro ou boca de lobo | | prop_problema | Indicador sintético de precariedade (presença de algum déficit) |

Para um uso correto do índice e interpretação espacial dos dados, é fundamental entender o que compõe a base:

Cobertura Viária vs. Dados Censitários: a malha geométrica (proveniente do Overture Maps) abrange todo o território nacional, incluindo estradas rurais e rodovias isoladas. No entanto, os indicadores de entorno do Censo 2022 (pavimentação, calçada, iluminação, bueiro) foram coletados pelo IBGE predominantemente em áreas urbanas habitadas. Vias localizadas fora desses recortes censitários estão presentes no pacote, mas recebem estritamente o valor NA (nulo) em seus indicadores de precariedade, prevenindo a falsa interpretação de infraestrutura perfeita (0%).
Foco residencial: os dados refletem a realidade de onde existem domicílios contados pelo Censo. Vias em distritos puramente industriais, grandes parques ecológicos ou zonas desabitadas não possuem o questionário de entorno aplicado e, portanto, também terão seus indicadores tratados como NA.
Geometria e Espacialização: as vias são derivadas do Overture Maps (tema Transportation), otimizadas (geometrias simplificadas para ganho de performance) e cruzadas espacialmente (st_intersects) para herdar os dados dos polígonos dos setores censitários correspondentes.

Nota sobre soberania de dados: este projeto é desenvolvido sob os princípios de ciência aberta e software livre, buscando democratizar o acesso a dados públicos complexos para pesquisadores, gestores e movimentos sociais.