---
id: types-geopandas
version: "1.1.4.20260807"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-geopandas — Typing stubs for geopandas

License: permissive · Maintenance: active · Downloads: 131.0K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 131.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geopandas type stubs, type hints for geopandas, mypy geopandas annotations, static typing geopandas, pyright geopandas types, geopandas type checking, type-stubs, geospatial

[View on SkillFed](https://skillfed.io/packages/types-geopandas) · [View on PyPI](https://pypi.org/project/types-geopandas/)