OvertureMaps / OvertureMaps/stac
Adopt `stac-partition-extension` on collections
Open
@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", andpartition:file_count = <fragment count>(already known — same value used for the collection'sitemlinks). - Fill
partition:keysfrom the theme/type Hive prefix (theme,type, bothstring). Confirm this matches the extension's intent — Overture's collections are per-(theme, type), so the keys are technically resolved at the collection level; leavingpartition:keys = []may be more accurate but the field is required by the spec (worth raising upstream if empty isn't valid).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.