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/