2023-11-06 05:51:33 +03:00
|
|
|
[![Martin](https://raw.githubusercontent.com/maplibre/martin/main/logo.png)](https://maplibre.org/martin/)
|
2017-10-09 14:29:03 +03:00
|
|
|
|
2023-06-01 17:11:42 +03:00
|
|
|
[![Book](https://img.shields.io/badge/docs-Book-informational)](https://maplibre.org/martin)
|
|
|
|
[![docs.rs docs](https://docs.rs/martin/badge.svg)](https://docs.rs/martin)
|
2023-12-25 09:49:39 +03:00
|
|
|
[![](https://img.shields.io/badge/Slack-%23maplibre--martin-blueviolet?logo=slack)](https://slack.openstreetmap.us/)
|
2023-06-01 17:11:42 +03:00
|
|
|
[![GitHub](https://img.shields.io/badge/github-maplibre/martin-8da0cb?logo=github)](https://github.com/maplibre/martin)
|
|
|
|
[![crates.io version](https://img.shields.io/crates/v/martin.svg)](https://crates.io/crates/martin)
|
|
|
|
[![Security audit](https://github.com/maplibre/martin/workflows/Security%20audit/badge.svg)](https://github.com/maplibre/martin/security)
|
2023-10-28 23:29:30 +03:00
|
|
|
[![CI build](https://github.com/maplibre/martin/actions/workflows/ci.yml/badge.svg)](https://github.com/maplibre/martin/actions)
|
2017-10-15 14:48:23 +03:00
|
|
|
|
2024-05-26 14:06:28 +03:00
|
|
|
Martin is a tile server able to generate and serve [vector tiles](https://github.com/mapbox/vector-tile-spec) on the fly
|
|
|
|
from large [PostGIS](https://github.com/postgis/postgis)
|
|
|
|
databases, [PMTile](https://protomaps.com/blog/pmtiles-v3-whats-new) (local or remote),
|
|
|
|
and [MBTile](https://github.com/mapbox/mbtiles-spec) files, allowing multiple tile sources to be dynamically combined
|
|
|
|
into one. Martin optimizes for speed and heavy traffic, and is written in [Rust](https://github.com/rust-lang/rust).
|
|
|
|
|
|
|
|
### Features
|
|
|
|
|
|
|
|
* Serve vector tiles from PostGIS, PMTile, and MBTile sources
|
|
|
|
* [Combine](https://maplibre.org/martin/sources-composite.html) multiple tile sources
|
|
|
|
* Generate [sprites](https://maplibre.org/martin/sources-sprites.html) and [font glyphs](https://maplibre.org/martin/sources-fonts.html)
|
|
|
|
* Generate tiles in bulk from any Martin-supported sources into an `.mbtiles` file with [martin-cp](https://maplibre.org/martin/martin-cp.html) tool
|
|
|
|
* Examine, copy, validate, compare, and apply diffs between `.mbtiles` files with [mbtiles](https://maplibre.org/martin/tools.html#mbtiles) tool
|
|
|
|
|
|
|
|
### Documentation
|
|
|
|
|
|
|
|
* [Quick Start](https://maplibre.org/martin/quick-start.html)
|
|
|
|
* [Installation](https://maplibre.org/martin/installation.html)
|
|
|
|
* Running with [CLI](https://maplibre.org/martin/run-with-cli.html)
|
|
|
|
or [configuration file](https://maplibre.org/martin/config-file.html)
|
|
|
|
* [Usage and API](https://maplibre.org/martin/using.html)
|
2023-07-25 23:20:41 +03:00
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
Licensed under either of
|
|
|
|
|
2023-07-27 19:21:58 +03:00
|
|
|
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0>)
|
|
|
|
* MIT license ([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT>)
|
2023-07-25 23:20:41 +03:00
|
|
|
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.
|