#tile #map #format #convert #serving #checking #toolbox

bin+lib opencloudtiles

A toolbox for converting, checking and serving map tiles in various formats

11 releases

0.1.11 Jan 20, 2023
0.1.10 Jan 20, 2023

#187 in Science

Download history 4/week @ 2024-02-13 196/week @ 2024-02-20 15/week @ 2024-02-27 3/week @ 2024-03-12

218 downloads per month

MIT license

115KB
3.5K SLoC

install

  • Install Rust (very easy)
  • Then run cargo install opencloudtiles (very easy, but compiling can take 1-2 minutes)

run

running opencloudtiles will list you the available commands:

Usage: opencloudtiles <COMMAND>

Commands:
  convert  Convert between different tile containers
  serve    Serve tiles via http
  probe    Show information about a tile container
  compare  Compare two tile containers

formats

feature cloudtiles pmtiles mbtiles tar
read container
- from file 🚧
- from http 🚧 🚧 🚫 🚫
- from gcs 🚧 🚧 🚫 🚫
- from S3 🚧 🚧 🚫 🚫
write container
- to file 🚧 🚧
precompression
- uncompressed 🚧 🚫
- gzip 🚧
- brotli 🚧 🚫

More on the cloudtiles container: github.com/OpenCloudTiles/opencloudtiles-specification

examples

cargo build && ./target/debug/opencloudtiles convert --tile-format webp tiles/original/hitzekarte.tar tiles/hitzekarte.tar
cargo build && ./target/debug/opencloudtiles convert tiles/original/stuttgart.mbtiles tiles/stuttgart.cloudtiles
cargo build && ./target/debug/opencloudtiles convert tiles/stuttgart.cloudtiles tiles/stuttgart.tar
cargo build && ./target/debug/opencloudtiles convert --min-zoom 14 --bbox -30,15,-20,20 ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-planet.mbtiles tiles/mostly_water.cloudtiles

cargo build && ./target/debug/opencloudtiles probe tiles/stuttgart.cloudtiles
cargo build && ./target/debug/opencloudtiles serve tiles/stuttgart.cloudtiles
cargo build && ./target/debug/opencloudtiles serve -s tiles/frontend tiles/stuttgart.cloudtiles

cargo build && ./target/debug/opencloudtiles serve -s tiles/frontend tiles/original/europe.mbtiles

cargo instruments --all-features -t "CPU Profiler" -- convert ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles tiles/test.cloudtiles

cargo build -r && ./target/release/opencloudtiles probe --scan ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles
cargo instruments --all-features -t "CPU Profiler" -- probe --scan ~/Dropbox/Dropbox\ upload/Dropbbox\ upload\ new/opencloudtiles/mbtiles/2023-01-eu-de.mbtiles

cargo publish --no-verify
cargo test
cargo bench "bench"

dev config

git config --local core.hooksPath .githooks/

Dependencies

~78MB
~1.5M SLoC