https://github.com/ropenspain/tidycenso

An R library for accesing the 2021 spanish census API.
https://github.com/ropenspain/tidycenso

api census r spain

Last synced: 3 months ago
JSON representation

An R library for accesing the 2021 spanish census API.

• Host: GitHub
• URL: https://github.com/ropenspain/tidycenso
• Owner: rOpenSpain
• License: gpl-3.0
• Created: 2023-09-04T11:06:01.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-09-07T14:40:12.000Z (about 2 years ago)
• Last Synced: 2025-01-02T15:49:58.443Z (9 months ago)
• Topics: api, census, r, spain
• Language: R
• Homepage: https://ropenspain.github.io/tidycenso/
• Size: 3.31 MB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.Rmd
  • License: LICENSE.md

Awesome Lists containing this project

README

          
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# tidycenso

[![R-CMD-check](https://github.com/rOpenSpain/tidycenso/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/rOpenSpain/tidycenso/actions/workflows/R-CMD-check.yaml) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

[![rOS-badge](https://ropenspain.github.io/rostemplate/reference/figures/ropenspain-badge.svg)](https://ropenspain.es/)

## Overview

`tidycenso` is an R library for accessing the 2021 Spanish census API.

## Installation

```{r, eval=FALSE}

devtools::install_github("ropenspain/tidycenso")

```

## Usage

`tidycenso` only has one function: `get_censo`. It admits 4 parameters:

1.  `table`: A string of length 1 with the table name to query data from

2.  `variables`: A string with variable names of the queried table. If more than one, must be provided using c() (max. 4)

3.  `metrics`: A string with the units of measurement of the queried data. If more than one, must be provided concatenated using `c()`

4.  `language`: The language used in the request body (the only valid values are 'EN' or 'ES')

The ids and descriptions of the available tables, variables and units of measurement (metrics) are accessible through internal data objects named `tables`, `variables`, and `metrics`.

## Example

```{r include=FALSE}

library(tidycenso)

```

```{r echo=TRUE}

df <- get_censo("hog", c("ID_SUP_VIV", "ID_RESIDENCIA_N1"), "SHOGARES")

head(df)

tidycenso::tables

```