Skip to contents

taf() reads installed TIGER Address Features for one or more ZIP codes. It reconstructs the county_fips, s2_geography, and addr_street vectors in the returned data frame. taf_install() installs one county's processed Parquet files from the stow-managed TIGER sources. Use taf_dataset() to query all installed flat files lazily with Arrow.

Usage

taf_install(
  county,
  year = as.character(2025:2011),
  version = "v2",
  overwrite = FALSE,
  redownload = FALSE
)

taf(x, map = TRUE, year = as.character(2025:2011), version = "v2")

Arguments

county

character, length 1; county FIPS code

year

character, length 1; vintage of TIGER addrfeat (address feature) files

version

character, length 1; major version of the package and taf dataset schema

overwrite

logical, length 1; overwrite an existing county install?

redownload

logical, length 1; replace existing durable managed local copies of TIGER ZIP files?

x

character vector of five-digit ZIP codes

map

logical, length 1; map street tags read from the TAF data (type, directional, ordinal) when converting to addr_street() vector?

Value

taf() returns a tibble with LINEARID, FULLNAME, side, ZIP, FROMHN, TOHN, PARITY, OFFSET, s2_geography, addr_street, county_fips, and street_tag_parsed columns. taf_install() invisibly returns the installed county FIPS identifier.

Details

About 6% of ADDRFEAT rows do not have a county-local primary FEATNAMES match by LINEARID. In these cases, street tags are parsed from the ADDRFEAT full name, and the street_tag_parsed column is set to TRUE.

Examples

if (FALSE) { # \dontrun{
  Sys.setenv("R_USER_DATA_DIR" = tempfile())
  taf_install("39061", "2025")
} # }
if (FALSE) { # \dontrun{
  Sys.setenv("R_USER_DATA_DIR" = tempfile())
  taf_install("39061", "2025")
  taf(c("45249", "45230", "45220"))
} # }