geodatasets

library2026.5.1pypypi✓ verified 85d ago

A collection of sample geospatial datasets for use with GeoPandas and other geospatial libraries in Python, providing easy access through a single `get_path()` function. Current version 2026.1.0, with monthly release cadence.

data

pip install geodatasets

github ↗package ↗

INSTALL

IMPORT

SIG · GEODATASETS

geodatasets

datapythonv2026.5.1

Install

2.3s avg

Import

197ms

Disk

21MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2026.5.1 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.206s · 22.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.3s · import 0.188s · 23MB

21MB installed

● package 21MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

get_path

✓ from geodatasets import get_path

✗ from geodatasets import get_data_path

The function is named get_path, not get_data_path.

Demonstrates how to retrieve the path to a built-in dataset and load it with GeoPandas.

from geodatasets import get_path import geopandas as gpd # Load the New York City boroughs dataset path = get_path('nybb') gdf = gpd.read_file(path) print(gdf.head())

Debug

Known issues

deprecatedDataset 'columbus' (GeoDa Columbus) was removed in version 2023.12.0; using it raises KeyError.

fix

Use 'nybb' (New York City boroughs) or another existing dataset.

affects: >=2023.12.0

gotcha`get_path()` returns a string path, not a GeoDataFrame. You must call `gpd.read_file()` separately.

fix

Always assign the result to a variable and use `gpd.read_file(path)`.

affects: all

gotchaDataset names are case-sensitive and must be exact (e.g., 'nybb', not 'NYBB' or 'nybb_22a').

fix

Refer to the official list of datasets at https://github.com/geopandas/geodatasets#datasets.

affects: all

Errors

Common errors & fixes

KeyError: 'columbus'

The 'columbus' dataset was removed in geodatasets 2023.12.0.

fix

Use a different dataset such as 'nybb' (New York boroughs).

ModuleNotFoundError: No module named 'geodatasets'

The package is not installed.

fix

Run `pip install geodatasets`.

AttributeError: module 'geodatasets' has no attribute 'get_data_path'

The correct function name is `get_path`, not `get_data_path`.

fix

Use `from geodatasets import get_path`.

Upgrade

Version history

2026.5.1latest on PyPI · released May 18, 2026

Audit

Dependencies

geopandasrequiredCore dependency for loading and working with geospatial data.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/geopandas/geodatasets ↗

packagehttps://pypi.org/project/geodatasets/ ↗