Descarga y/o carga desde caché los datos de viviendas del Censo de Población y Vivienda 2024 de Bolivia, con filtros geográficos opcionales.
Arguments
- departamento
Vector de caracteres. Código(s) de departamento (`"01"`-`"09"`) o nombre(s) (e.g., `"La Paz"`, `"Santa Cruz"`). Si `NULL`, incluye todos los departamentos (descarga ~282 MB).
- provincia
Vector de caracteres. Código(s) (`"01"`) o nombre(s) (`"Cercado"`) de provincia. Si `NULL`, incluye todas. Los valores no existentes producen un error (en vez de un resultado vacío silencioso).
- municipio
Vector de caracteres. Código(s) (`"01"`) o nombre(s) (`"Cochabamba"`) de municipio. Si `NULL`, incluye todos. Si se especifica `provincia`/`municipio` sin `departamento`, este se infiere del catálogo para no descargar todo el país. Un nombre repetido entre departamentos requiere indicar `departamento` para desambiguar.
Los nombres de los tres niveles se comparan sin distinguir mayúsculas/minúsculas ni acentos, así que `"Potosi"` y `"Zudanez"` valen igual que `"Potosí"` y `"Zudáñez"`.
- variables
Vector de caracteres. Nombres de columnas a seleccionar. Si `NULL`, devuelve todas (119 columnas). Las columnas geográficas (`idep`, `iprov`, `imun`, `i00`) siempre se incluyen.
- universo
Qué registros de la entidad devolver: - `"viviendas"` (por defecto): el universo oficial del INE, 4.480.201 viviendas. Excluye a las personas censadas en la calle o en tránsito. - `"particulares"`: solo viviendas particulares (4.463.773). - `"colectivas"`: solo viviendas colectivas (16.428). - `"todos"`: los 4.490.488 registros crudos de la entidad de REDATAM, incluidas las personas en la calle y en tránsito.
Ver [tipos_vivienda()] para el detalle código a código.
- as
Formato de retorno: `"arrow"` (por defecto), `"tibble"` o `"duckdb"` (tabla `"viviendas"`).
- overwrite
Lógico. Si `TRUE`, re-descarga aunque exista en caché.
- verbose
Lógico. Mostrar mensajes de progreso. Por defecto `TRUE`.
Details
La tabla de viviendas contiene 48 variables. Se puede unir con [get_personas_2024()] usando la clave `idep + iprov + imun + i00`.
Para viviendas de censos históricos usa [get_viviendas_1992()], [get_viviendas_2001()], [get_viviendas_2012()] o [get_censo()].
El universo de vivienda
La entidad `vivienda` de REDATAM tiene 4.490.488 registros, pero **10.287 no son viviendas**: son personas censadas fuera de una vivienda, marcadas en `v01_tipoviv` como *persona que vive en la calle* (código 15, 3.311 registros) o *en tránsito: terminal, aeropuerto, puerto u otro* (código 16, 6.976). El INE no las cuenta como viviendas en ningún tabulado, y descontarlas da exactamente su total oficial de **4.480.201 viviendas** —también por área (2.898.140 urbanas y 1.582.061 rurales) y en los 343 municipios, donde coincide al registro con las viviendas del geoportal ([get_unidades_2024()]).
Por eso el defecto es `universo = "viviendas"`. Para contar los registros crudos de la entidad, como los devuelve REDATAM, usa `universo = "todos"`.
El filtro necesita la columna `v01_tipoviv`: si pasas `variables` sin incluirla, se añade automáticamente al resultado.
Examples
if (FALSE) { # \dontrun{
# Viviendas de Cochabamba (universo oficial)
get_viviendas_2024(departamento = "Cochabamba")
# Solo viviendas colectivas del país
get_viviendas_2024(universo = "colectivas")
# La entidad cruda de REDATAM, con calle y tránsito
get_viviendas_2024(universo = "todos")
# Condiciones de servicios básicos en Oruro
library(dplyr)
get_viviendas_2024(departamento = "04",
variables = c("urbrur", "v07_aguapro", "v09_energia")) |>
count(urbrur, v07_aguapro) |>
collect()
} # }