Learn R Programming

tigris

tigris is an R package that allows users to directly download and use TIGER/Line shapefiles (https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) from the US Census Bureau.

To install the package from CRAN, issue the following command in R:

install.packages('tigris')

Or, get the development version from GitHub:

devtools::install_github('walkerke/tigris')

tigris functions return simple features objects with a default year of 2024. To get started, choose a function from the table below and use it with a state and/or county if required. You'll get back an sf object for use in your mapping and spatial analysis projects:

library(tigris)
library(ggplot2)

manhattan_roads <- roads("NY", "New York")

ggplot(manhattan_roads) + 
  geom_sf() + 
  theme_void()

tigris only returns feature geometries for US Census data which default to the coordinate reference system NAD 1983 (EPSG: 4269). For US Census demographic data (optionally pre-joined to tigris geometries), try the tidycensus package. For help deciding on an appropriate coordinate reference system for your project, take a look at the crsuggest package.

To learn more about how to use tigris, read Chapter 5 of the book Analyzing US Census Data: Methods, Maps, and Models in R.

Python users may also be interested in pygris, a Python port of the tigris package.

Available datasets:

Please note: cartographic boundary files in tigris are not available for 2011 and 2012.

FunctionDatasets availableYears available
nation()cartographic (1:5m; 1:20m)2013-2024
divisions()cartographic (1:500k; 1:5m; 1:20m)2013-2024
regions()cartographic (1:500k; 1:5m; 1:20m)2013-2024
states()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)1990, 2000, 2010-2024
counties()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)1990, 2000, 2010-2024
tracts()TIGER/Line; cartographic (1:500k)1990, 2000, 2010-2024
block_groups()TIGER/Line; cartographic (1:500k)1990, 2000, 2010-2024
blocks()TIGER/Line2000, 2010-2024
places()TIGER/Line; cartographic (1:500k)2011-2024
pumas()TIGER/Line; cartographic (1:500k)2012-2024
school_districts()TIGER/Line; cartographic2011-2024
zctas()TIGER/Line; cartographic (1:500k)2000, 2010, 2012-2024
congressional_districts()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2024
state_legislative_districts()TIGER/Line; cartographic (1:500k)2011-2024
voting_districts()TIGER/Line2012, 2020
area_water()TIGER/Line2011-2024
linear_water()TIGER/Line2011-2024
coastlineTIGER/Line()2013-2024
core_based_statistical_areas()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2021, 2023-2024 (not available for 2022)
combined_statistical_areas()TIGER/Line; cartographic (1:500k; 1:5m; 1:20m)2011-2024
metro_divisions()TIGER/Line2011-2024
new_england()TIGER/Line; cartographic (1:500k)2011-2021 (no longer used by Census)
county_subdivisions()TIGER/Line; cartographic (1:500k)2010-2024
urban_areas()TIGER/Line; cartographic (1:500k)2012-2024
primary_roads()TIGER/Line2011-2024
primary_secondary_roads()TIGER/Line2011-2024
roads()TIGER/Line2011-2024
rails()TIGER/Line2011-2024
native_areas()TIGER/Line; cartographic (1:500k)2011-2024
alaska_native_regional_corporations()TIGER/Line; cartographic (1:500k)2011-2024
tribal_block_groups()TIGER/Line2011-2024
tribal_census_tracts()TIGER/Line2011-2024
tribal_subdivisions_national()TIGER/Line2011-2024
landmarks()TIGER/Line2011-2024
military()TIGER/Line2011-2024

Copy Link

Version

Install

install.packages('tigris')

Monthly Downloads

11,400

Version

2.2.1

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Kyle Walker

Last Published

April 16th, 2025

Functions in tigris (2.2.1)

county_subdivisions

Download a county subdivision shapefile into R
core_based_statistical_areas

Download a core-based statistical area shapefile into R
filter_place

Filter a places Spatial object for only those places matching the contents of the place vector.
counties

Download a US Counties shapefile into R, and optionally subset by state
fips_codes

Dataset with FIPS codes for US states and counties
filter_state

Filter a states Spatial object for only those states matching the contents of the state vector.
divisions

Download a US Census divisions cartographic boundary shapefile into R
erase_water

Erase water area from an input polygon dataset
congressional_districts

Download a congressional districts shapefile into R
load_tiger_doc_template

Documentation Template for Functions that Utilize load_tiger
load_tiger

Helper function to download Census data
geo_join

Easily merge a data frame to a spatial data frame
grep_place

Find places matching a term in a places object
linear_water

Download an linear water shapefile into R
list_places

Return a list of all the places in a places object
grep_state

Find states matching a term in a state object
list_counties

Return a data frame of county names & FIPS codes for a given state
lookup_code

Look up state and county codes
landmarks

Download a point or area landmarks shapefile into R
is_tigris

Returns TRUE if obj has a tigris attribute
primary_secondary_roads

Download a primary & secondary roads shapefile into R
pumas

Download a Public Use Microdata Area (PUMA) shapefile into R
list_states

Return a list of all the states in a state object
places

Download Shapefiles which include both incorporated places (legal entities) and census designated places (statistical entities) into R
primary_roads

Download a national primary roads shapefile into R
metro_divisions

Download a metropolitan divisions shapefile into R.
rbind_tigris

Row-bind tigris Spatial objects
rails

Download a national rails shapefile into R
school_districts

Download a school district shapefile into R
shift_geometry

Shift and rescale Alaska, Hawaii, and Puerto Rico in a US-wide sf object
nation

Download a US national boundary shapefile into R
military

Download the Military Installation National Shapefile into R
tigris

Download and use U.S. Census TIGER shapefiles in R
tigris-exports

tigris exported operators
regions

Download a US regions cartographic boundary shapefile into R
roads

Download a roads shapefile into R
native_areas

Download an American Indian / Alaska Native / Native Hawaiian Areas shapefile into R.
new_england

Download a New England City and Town Area shapefile into R
state_legislative_districts

Download a state legislative districts shapefile into R - upper or lower
tracts

Download a Census tracts shapefile into R, and optionally subset by county
tigris_cache_dir

Set the cache directory to store shapefiles with tigris
tigris_type

Get the type of tigris object obj is
tribal_block_groups

Download a Tribal block groups shapefile into R.
voting_districts

Download a voting districts shapefile into R
urban_areas

Download an urban areas shapefile into R
states

Download shapefile for all states into R
zctas

Download a Zip Code Tabulation Area (ZCTA) shapefile into R
tribal_census_tracts

Download a Tribal Census tract shapefile into R.
tribal_subdivisions_national

Download an American Indian Tribal Subdivision National shapefile into R.
coastline

Download a shapefile of the US coastline into R
call_geolocator

Call geolocator for one address
area_water

Download an area water shapefile into R
append_geoid

Retrieve GEOID from the Census Geocoder by address
block_groups

Download a Census block groups shapefile into R, and optionally subset by county
call_geolocator_latlon

Call geolocator for one address with lat/lon, adds option to set benchmark and vintage if not provided it will default to the most recent.
combined_statistical_areas

Download a combined statistical areas shapefile into R
blocks

Download a Census block shapefile into R
address_ranges

Download an address range features shapefile into R
alaska_native_regional_corporations

Download an Alaska Native Regional Corporation shapefile into R.