get_census_api_2: Census API URL assembler.

In wru: Who are You? Bayesian Prediction of Racial Category Using Surname, First Name, Middle Name, and Geolocation

Census API URL assembler.

Description

get_census_api_2 assembles URL components for get_census_api.

Usage

get_census_api_2(
  data_url,
  key = Sys.getenv("CENSUS_API_KEY"),
  get,
  region,
  retry = 3
)

Arguments

data_url	URL root of the API, e.g., "https://api.census.gov/data/2020/dec/pl".
key	A character string containing a valid Census API key, which can be requested from the U.S. Census API key signup page. By default, attempts to find a census key stored in an environment variable named CENSUS_API_KEY.
get	A character vector of variables to get, e.g., c("P2_005N", "P2_006N", "P2_007N", "P2_008N"). If there are more than 50 variables, then function will automatically split variables into separate queries.
region	Character object specifying which region to obtain data for. Must contain "for" and possibly "in", e.g., "for=block:1213&in=state:47+county:015+tract:*".
retry	The number of retries at the census website if network interruption occurs.

Details

This function assembles the URL components and sends the request to the Census server. It is used by the get_census_api function. The user should not need to call this function directly.

Value

If successful, output will be an object of class data.frame. If unsuccessful, function prints the URL query that was constructed.

References

Based on code authored by Nicholas Nagle, which is available here.

Examples

## Not run: try(get_census_api_2(data_url = "https://api.census.gov/data/2020/dec/pl",
get = c("P2_005N", "P2_006N", "P2_007N", "P2_008N"), region = "for=county:*&in=state:34"))
## End(Not run)

wru documentation built on May 29, 2024, 9:46 a.m.