States, provinces, and first-level subdivisions#

states-provinces · theme boundaries · live

First-level administrative units: US states from the Census Bureau, states and provinces worldwide from Natural Earth, or geoBoundaries ADM1.

import easysnowdata as esd

aoi = (-121.94, 46.72, -121.54, 46.99)   # Mount Rainier
states_gdf = esd.boundaries.admin.states(aoi)

No account needed

Every route to this product is open. Nothing to set up.

Sources#

3 routes serve this product; the first is the default and source= picks another. The return contract is the same either way.

source

provider

credentials

resolution

extent

temporal

latency

notes

natural-earth (default)

vector_http

none

—

global

static (v5.1.1; a few layers 5.0.0)

—

zipped shapefile, cached on first use; 1:10m and 1:50m

us-census

vector_http

none

—

United States

yearly releases

—

1:500k, 1:5m or 1:20m zipped shapefile, NAD83 reprojected to EPSG:4326

geoboundaries

vector_http

none

—

global

continuously updated

—

ADM1; one country per request through the gbOpen API, GeoJSON cached per release

Where each route points#

natural-earth — Natural Earth live

https://naciscdn.org/naturalearth/<scale>/cultural/ne_<scale>_admin_1_states_provinces.zip

us-census — US Census cartographic boundaries live

https://www2.census.gov/geo/tiger/GENZ<year>/shp/cb_<year>_us_state_<resolution>.zip

geoboundaries — geoBoundaries (gbOpen) live

https://www.geoboundaries.org/api/current/gbOpen/<ISO3>/ADM<level>/

Variables#

variable

units

dtype

nodata

categorical

name

—

—

—

no

iso3

—

—

—

no

admin_level

—

—

—

no

Provenance#

Licence · Public domain (Natural Earth, US Census); CC BY 4.0 (geoBoundaries)

Cite the data as

Natural Earth. Free vector and raster map data @ naturalearthdata.com. U.S. Census Bureau (2025). Cartographic Boundary Files. https://www.census.gov/geographies/mapping-files/time-series/geo/cartographic-boundary.html

Documentation

Loader · easysnowdata.boundaries.admin.states