#gis #back-end #tile #async-http #spec #tokio

pmtiles

Implementation of the PMTiles v3 spec with multiple sync and async backends

21 releases (10 breaking)

0.10.0 May 2, 2024
0.8.0 Apr 10, 2024
0.7.1 Feb 13, 2024
0.5.2 Dec 24, 2023
0.0.5 Oct 22, 2022

#36 in Geospatial

Download history 89/week @ 2024-03-02 143/week @ 2024-03-09 91/week @ 2024-03-16 171/week @ 2024-03-23 253/week @ 2024-03-30 473/week @ 2024-04-06 164/week @ 2024-04-13 58/week @ 2024-04-20 272/week @ 2024-04-27 101/week @ 2024-05-04 111/week @ 2024-05-11 106/week @ 2024-05-18 146/week @ 2024-05-25 123/week @ 2024-06-01 149/week @ 2024-06-08 184/week @ 2024-06-15

643 downloads per month
Used in martin

MIT/Apache

4.5MB
1K SLoC

PMTiles (for Rust)

GitHub crates.io version docs.rs docs crates.io version CI build

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

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.

Dependencies

~1–18MB
~269K SLoC