types-geopandas

library1.1.3.20260518pypypiunverified

PEP 561 typing stubs for geopandas, provided by typeshed. Version 1.1.3.20260408 supports Python >=3.10. These stubs allow static type checkers like mypy and pyright to understand geopandas types. They are released on a rolling schedule, synced to geopandas releases.

type-stubs data

pip install types-geopandas

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · TYPES-GEOPANDAS

types-geopandas

type-stubspythonv1.1.3.20260518

Install

4.3s avg

Import

—

Disk

122MB

Pass rate

9/ 10

Env Coverage9 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.1.3.20260518 · 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

glibc

py 3.10

✓ —

✓ 4.2s

py 3.11

✓ —

✓ 4.2s

py 3.12

✓ —

✓ 3.9s

py 3.13

✓ —

✓ 3.9s

py 3.9

✕ build_error

✓ 5.3s

122MB installed

● package 122MB

Code

Verified usage

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

GeoDataFrame

✓ from geopandas_stubs import GeoDataFrame

✗ from geopandas_stubs import GeoDataFrame

Basic usage: import geopandas, use read_file to get a GeoDataFrame with type hints.

import geopandas as gpd # Ensure stubs are installed (types-geopandas) so mypy can check # Example: create a GeoDataFrame from a file # Replace 'filepath' with a real path or use built-in example # df: gpd.GeoDataFrame = gpd.read_file('filepath') # Example with world dataset (requires geopandas.datasets) df = gpd.read_file(gpd.datasets.get_path('naturalearth_lowres')) print(type(df)) # mypy will infer GeoDataFrame thanks to stubs

Debug

Known issues

gotchatypes-geopandas is not the same as geopandas itself. You must install geopandas separately (pip install geopandas). Many users mistakenly think installing types-geopandas provides geopandas functionality.

fix

Ensure both are installed: pip install geopandas types-geopandas

affects: all

deprecatedOlder versions of geopandas used shapely.geometry types directly. In geopandas >=0.12, they moved to using shapely 2.0 Geometry types. The stubs reflect this, so code expecting old type names may break.

fix

Use shapely.geometry.Point (or other) as the underlying geometry type. For example: from shapely.geometry import Point

affects: types-geopandas >=0.12

gotchaThe stubs are auto-generated and may lag behind geopandas releases. If you encounter type errors that seem incorrect, check if a newer types-geopandas version is available. If not, you may need to add inline # type: ignore comments.

fix

Upgrade: pip install --upgrade types-geopandas

affects: all

Upgrade

Version history

1.1.3.20260518latest on PyPI · released May 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

40 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/typeshed-internal/stub_uploader ↗

packagehttps://pypi.org/project/types-geopandas/ ↗

changeloghttps://github.com/typeshed-internal/stub_uploader/blob/main/data/changelogs/geopandas.md ↗