OvertureMaps / OvertureMaps/stac

Adopt `stac-partition-extension` on collections

Open
#129 1 comment 0 reactions 1 assignee View on GitHub

@jjcfrancisco is already working on this.

Since Sep 4, 2026.

Dominant language
Rust
Stars
39
Forks
3
Avg merge
4d 18m
Merged PRs (30d)
7

Description

Type

Task

Scope

Multi-theme or Platform

Skillset

engineering

Description

Context

Consumers currently reconstruct the parquet glob (.../release/<version>/theme=<X>/type=<Y>/*.parquet) from documentation before they can query with DuckDB, PyArrow, or GDAL. The stac-partition-extension puts that glob and its layout on the Collection itself so tools discover it directly. Overture's per-(theme, type) collection layout was the extension's motivating example.

Proposed change

In theme.rs:

  • Add the partition extension schema to the collection's stac_extensions.
  • Set partition:scheme = "hive", partition:glob = "https://overturemaps-us-west-2.s3.us-west-2.amazonaws.com/release/<release>/theme=<theme>/type=<type>/*.parquet", and partition:file_count = <fragment count> (already known — same value used for the collection's item links).
  • Fill partition:keys from the theme/type Hive prefix (theme, type, both string). Confirm this matches the extension's intent — Overture's collections are per-(theme, type), so the keys are technically resolved at the collection level; leaving partition:keys = [] may be more accurate but the field is required by the spec (worth raising upstream if empty isn't valid).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.