types-geopandas

What it is and what it does

types-geopandas is a type stub package that provides static type annotations for the geopandas geospatial data library. It allows type checkers like mypy, pyright, and ty to understand and validate code that imports and uses geopandas, catching type errors before runtime. The stubs are maintained as part of the typeshed project and are tested against multiple type checkers to ensure accuracy.

This package is installed alongside geopandas (or in parallel) to enable IDE autocomplete, type checking in CI/CD pipelines, and better developer experience when working with geospatial data. It depends on type stubs for geopandas's own dependencies—numpy, pandas-stubs, types-shapely, and pyproj—so installing it pulls in a minimal set of metadata-only packages with no compiled code.

Use it for:

• Enable mypy or pyright to catch type errors in scripts that read or manipulate GeoDataFrames.
• Get IDE autocomplete and type hints when writing geopandas code in VS Code or PyCharm.
• Enforce type safety in geospatial data pipelines as part of a CI/CD linting step.
• Validate function signatures that accept or return geopandas objects in a larger codebase.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides type annotations for the geopandas library, enabling static type checkers like mypy and pyright to validate code that uses geopandas.

Yes, if you use geopandas and want static type checking. Install it alongside geopandas to unlock type validation and IDE support. No downside: it's permissively licensed, actively maintained, has no heavy dependencies, and requires only Python 3.10+. Omit it only if you don't use a type checker or don't care about type safety in geospatial code.

Install

types-geopandas on PyPI

pip install types-geopandas

uv add types-geopandas

poetry add types-geopandas

Installing types-geopandas

Before you install

Low friction to install; actively maintained with a release 7 days ago. Runtime dependencies are all type stub or metadata packages (numpy, pandas-stubs, types-shapely, pyproj), so no compiled libraries or heavy dependencies to resolve.

License in practice

Licensed under Apache-2.0 (permissive), so you can use this in commercial and proprietary projects without restriction or attribution requirements.

Quickstart

pip install types-geopandas

# In your code, type checkers will now understand geopandas imports:
import geopandas as gpd
from geopandas import GeoDataFrame

Requires Python 3.10 or later; intended for use with a type checker (mypy, pyright, or ty) rather than runtime.

Verify before relying

• Whether this stub version remains accurate for geopandas versions other than 1.1.4, or if version pinning is necessary.
• Coverage completeness: whether all geopandas APIs are annotated or if some remain untyped.

Package facts

Evidence: types_geopandas-1.1.4.20260807-py3-none-any.whl

Tags

More Quality Assurance packages