gpq-tiles

Fast GeoParquet → PMTiles converter in Rust.

⚠️ Work in Progress: Code is generated with Claude; take it with a grain of salt. A couple of known issues:

1. We've had a regression since #63 and the conversion is hanging on large geoms again. I'm investigating.
2. The library is not robust against self-intersections. I'm working on a port of Wagyu to Rust to address this. In the meantime, this library is definitely not production-ready. --Nissim

Install

cargo install gpq-tiles    # CLI
pip install gpq-tiles      # Python

Usage

gpq-tiles input.parquet output.pmtiles --min-zoom 0 --max-zoom 14

from gpq_tiles import convert

# Basic
convert("input.parquet", "output.pmtiles", min_zoom=0, max_zoom=14)

# With property filtering and progress
convert(
    "buildings.parquet", "buildings.pmtiles",
    include=["name", "height"],
    progress_callback=lambda e: print(f"{e['phase']}: {e.get('total_tiles', '...')}")
)

Documentation

• Getting Started — Installation, basic usage, property filtering
• Advanced Usage — Performance tuning, streaming, CI/CD
• API Reference — CLI flags, Rust API, Python API

Development

git clone https://github.com/geoparquet-io/gpq-tiles.git && cd gpq-tiles
cargo build && cargo test

See CONTRIBUTING.md for details.

License

Apache-2.0