---
id: pystac-ext-projection
version: "2.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-projection — Projection extension for PySTAC

License: permissive · Maintenance: active · Downloads: 4.0M/mo

## What it is and what it does

pystac-ext-projection is a PySTAC extension package that adds standardized projection metadata fields to STAC items and collections. It implements the Projection Extension specification, enabling you to describe the geospatial projection of raster data through fields like EPSG code, WKT2 representation, PROJJSON, geometry bounds, centroid, shape, and coordinate transformation parameters.

The package supports multiple versions of the Projection Extension specification (v2.0.0, v1.2.0, v1.1.0, v1.0.0) and is designed to integrate seamlessly with PySTAC workflows. It depends only on pystac-core, making it lightweight to add to existing STAC catalog tooling. The package is actively maintained and targets modern Python versions (3.10–3.13).

Use it for:

- Add EPSG and WKT2 projection metadata to satellite imagery STAC items for geospatial discovery.
- Describe raster data coordinate systems and bounds in STAC collections for interoperability.
- Store coordinate transformation parameters (affine transform, shape) alongside raster assets.
- Build STAC catalogs for multi-projection datasets with standardized projection fields.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Extends PySTAC to add geospatial projection metadata fields (EPSG code, WKT2, PROJJSON, geometry, bounding box, centroid, shape, transform) to STAC items and collections.

Yes, if you are building or extending STAC catalogs for geospatial raster data. The package is lightweight, actively maintained, has no known vulnerabilities, and provides a standard way to attach projection metadata. Install it when you need to document spatial reference systems in PySTAC items or collections.

## Install

pip install pystac-ext-projection
uv add pystac-ext-projection
poetry add pystac-ext-projection

## Installing pystac-ext-projection

Before you install: Low install friction with a single runtime dependency (pystac-core). Active maintenance with a recent release (4 days old) and steady repository activity.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install pystac-ext-projection

from pystac_ext_projection import ProjectionExtension

# Use with a PySTAC item to add projection metadata
ProjectionExtension.add_to(item)

Requires Python 3.10 or later.

Verify before relying:

- Whether the package provides a complete API reference or usage guide beyond the extension specification.
- How projection metadata is validated or enforced when added to STAC items.

## Package facts

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

## Tags

STAC projection extension, geospatial projection metadata, EPSG code STAC, PySTAC projection fields, raster projection catalog, STAC geometry transform, spatial reference STAC, stac-extension, geospatial, metadata

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