landmarks: Download a point or area landmarks shapefile into R

View source: R/landmarks.R

landmarksR Documentation

Download a point or area landmarks shapefile into R

Description

Description from the US Census Bureau: "The Census Bureau includes landmarks in the MAF/TIGER database (MTDB) for locating special features and to help enumerators during field operations. Some of the more common landmark types include area landmarks such as airports, cemeteries, parks, and educational facilities and point landmarks such as schools and churches."

Usage

landmarks(state, type = "point", year = NULL, ...)

Arguments

state

The state for which you'd like to download the landmarks

type

Whether you would like to download point landmarks ("point") or area landmarks ("area"). #' Defaults to "point".

year

the data year; defaults to 2021

...

arguments to be passed to internal function load_tiger, which is not exported. See Additional Arguments.

Details

The Census Bureau adds landmark features to the database on an as-needed basis and makes no attempt to ensure that all instances of a particular feature were included. The absence of a landmark such as a hospital or prison does not mean that the living quarters associated with that landmark were excluded from the 2010 Census enumeration. The landmarks were not used as the basis for building or maintaining the address list used to conduct the 2010 Census.

Area landmark and area water features can overlap; for example, a park or other special land-use feature may include a lake or pond. In this case, the polygon covered by the lake or pond belongs to a water feature and a park landmark feature. Other kinds of landmarks can overlap as well. Area landmarks can contain point landmarks, but these features are not linked in the TIGER/Line Shapefiles.

Landmarks may be identified by a MAF/TIGER feature class code only and may not have a name. Each landmark has a unique area landmark identifier (AREAID) or point landmark identifier (POINTID) value.

Additional Arguments

Additional arguments that can be passed in ... are:

  • class Desired class of return object: "sf" (the default) or "sp". sp classes should be considered deprecated as of tigris version 2.0, but legacy support is still available.

  • progress_bar If set to FALSE, do not display download progress bar (helpful for R Markdown documents). Defaults to TRUE.

  • keep_zipped_shapefile If set to TRUE, do not delete zipped shapefile (stored in temporary directory or TIGRIS_CACHE_DIR depending on the configuration of global option "tigris_use_cache"). Defaults to FALSE.

  • refresh Whether to re-download cached shapefiles (TRUE or FALSE) . The default is either FALSE or the value of global option "tigris_refresh" if it is set. Specifying this argument will override the behavior set in "tigris_refresh" global option.

  • filter_by Geometry used to filter the output returned by the function. Can be an sf object, an object of class bbox, or a length-4 vector of format c(xmin, ymin, xmax, ymax) that can be converted to a bbox. Geometries that intersect the input to filter_by will be returned.

See Also

https://www2.census.gov/geo/pdfs/maps-data/data/tiger/tgrshp2020/TGRSHP2020_TechDoc_Ch3.pdf


tigris documentation built on Sept. 22, 2023, 5:13 p.m.