PMTiles (for Rust)

This crate implements the PMTiles v3 spec, originally created by Brandon Liu for Protomaps.

Features

• Opening and validating PMTile archives
• Querying tiles
• Backends supported:
  • Async mmap (Tokio) for local files
  • Async http and https (Reqwuest + Tokio) for URLs
  • Async s3 (Rust-S3 + Tokio) for S3-compatible buckets

Plans & TODOs

• Documentation and example code
• Support writing and conversion to and from MBTiles + x/y/z
• Support additional backends (sync mmap and http at least)
• Support additional async styles (e.g., async-std)

PRs welcome!

Development

• This project is easier to develop with just, a modern alternative to make. Install it with cargo install just.
• To get a list of available commands, run just.
• To run tests, use just test.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Test Data License

Some PMTile fixtures copied from official PMTiles repository.