versatiles 0.3.3

A toolbox for converting, checking and serving map tiles in various formats.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48


[![Crates.io](https://img.shields.io/crates/v/versatiles)](https://crates.io/crates/versatiles)
[![Crates.io](https://img.shields.io/crates/d/versatiles)](https://crates.io/crates/versatiles)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Code Coverage](https://codecov.io/gh/versatiles-org/versatiles-rs/branch/main/graph/badge.svg?token=IDHAI13M0K)](https://codecov.io/gh/versatiles-org/versatiles-rs)

# install

- Install [Rust](https://doc.rust-lang.org/cargo/getting-started/installation.html)
- Then run `cargo install versatiles`

# run

running `versatiles` will list you the available commands:
```
Usage: versatiles <COMMAND>

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

# formats

| feature             | versatiles | mbtiles | tar |
|---------------------|------------|---------|-----|
| **read container**  |            |         |     |
| - from file         | ✅          | ✅       | ✅   |
| - from http         | ✅          | 🚫      | 🚫  |
| - from gcs          | 🚧         | 🚫      | 🚫  |
| - from S3           | 🚧         | 🚫      | 🚫  |
| **write container** |            |         |     |
| - to file           | ✅          | 🚫      | ✅   |
| **compression**     |            |         |     |
| - uncompressed      | ✅          | 🚫      | ✅   |
| - gzip              | ✅          | ✅       | ✅   |
| - brotli            | ✅          | 🚫      | ✅   |

More about the VersaTiles container format: [github.com/versatiles-org/**versatiles-spec**](https://github.com/versatiles-org/versatiles-spec)

# examples

```bash
versatiles convert --tile-format webp satellite_tiles.tar satellite_tiles.versatiles

versatiles serve satellite_tiles.versatiles
```