Skip to content

stac Command

For detailed usage and examples, see the STAC User Guide.

Quick Reference

gpio stac --help

This will show all available options and examples.

Command Overview

Generate STAC Item or Collection from GeoParquet file(s).

Single file → STAC Item JSON Partitioned directory → STAC Collection + Items

Automatically detects PMTiles overview files and includes them as assets.

Examples

# Single file
gpio stac input.parquet output.json --bucket s3://my-bucket/roads/

# Partitioned dataset
gpio stac partitions/ stac-output/ --bucket s3://my-bucket/roads/

# With public URL mapping
gpio stac data.parquet output.json \
  --bucket s3://my-bucket/roads/ \
  --public-url https://data.example.com/roads/

# Overwrite existing STAC files
gpio stac partitions/ stac-output/ \
  --bucket s3://my-bucket/roads/ \
  --overwrite