Get data from the US Census Bureau Population Estimates APIs
get_estimates(geography, product = NULL, variables = NULL,
breakdown = NULL, breakdown_labels = FALSE, year = 2017,
state = NULL, county = NULL, time_series = FALSE,
output = "tidy", geometry = FALSE, keep_geo_vars = FALSE,
shift_geo = FALSE, key = NULL, ...)The geography of your data.
The data product (optional). "population", "components"
"housing", and "characteristics" are supported.
A character string of requested variables to get specific variables from the population, components, and housing APIs.
The population breakdown used when product = "characteristics".
Acceptable values are "AGEGROUP", "RACE", "SEX", and
"HISP", for Hispanic/Not Hispanic. These values can be combined in
a vector, returning population estimates in the value column for all
combinations of these breakdowns.
Whether or not to label breakdown elements returned when
product = "characteristics". Defaults to FALSE.
The data year (defaults to 2017)
The state for which you are requesting data. State names, postal codes, and FIPS codes are accepted. Defaults to NULL.
The county for which you are requesting data. County names and FIPS codes are accepted. Must be combined with a value supplied to `state`. Defaults to NULL.
If TRUE, the function will return a time series of observations back to the decennial Census
of 2010. The returned column is either "DATE", representing a particular estimate date, or "PERIOD",
representing a time period (e.g. births between 2016 and 2017), and contains integers representing
those values. Integer to date or period mapping is available at
https://www.census.gov/data/developers/data-sets/popest-popproj/popest/popest-vars/2017.html.
One of "tidy" (the default) in which each row represents an enumeration unit-variable combination, or "wide" in which each row represents an enumeration unit and the variables are in the columns.
if FALSE (the default), return a regular tibble of ACS data. if TRUE, uses the tigris package to return an sf tibble with simple feature geometry in the `geometry` column.
if TRUE, keeps all the variables from the Census shapefile obtained by tigris. Defaults to FALSE.
if TRUE, returns geometry with Alaska and Hawaii shifted for thematic mapping of the entire US.
Your Census API key.
Obtain one at http://api.census.gov/data/key_signup.html. Can be stored
in your .Renviron with census_api_key("YOUR KEY", install = TRUE)
other keyword arguments
A tibble, or sf tibble, of population estimates data