Skip to content

Commit 901066c

Browse files
committed
add to PMTiles concepts page
* comparisons to mbtiles, cog, individual tiles * pmtiles-rs * list supported browser renderers
1 parent 54a0daf commit 901066c

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

pmtiles/index.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,24 @@ PMTiles is a single-file archive format for pyramids of tiled data. A PMTiles ar
1515

1616
* The arrangement of tiles and directories is designed to minimize the amount of overhead requests when panning and zooming.
1717

18+
* PMTiles is a **read-only** format. It is not possible to update an archive in-place without re-writing the entire file, similar to CSV, JSON and Parquet. If you need transactional updates, use a database like SQLite or [PostgreSQL](http://postgis.net) + [ST_asMVT](https://postgis.net/docs/ST_AsMVT.html).
19+
1820
The current specification version of PMTiles is version 3, which you can [read on GitHub.](https://github.com/protomaps/PMTiles/blob/master/spec/v3/spec.md)
1921

22+
## Comparisons
23+
24+
### Individual files
25+
26+
An alternative to PMTiles is uploading each tile separately in a directory tree like `/Z/X/Y.mvt`. This works great for small tilesets, but uploading full global pyramid, such as 300 million tiles, could cost 1,500 USD in request fees and take days. PMTiles is a single file to upload and de-duplicates tiles internally, reducing size by 70%+ or more for global vector basemaps.
27+
28+
### MBTiles
29+
30+
[MBTiles](https://github.com/mapbox/mbtiles-spec) is a container format for tiled data, just like PMTiles, but based on SQLite. MBTiles are designed to be accessed on disk from a running server process, while PMTiles is designed to be read remotely over HTTP, with at most two cacheable intermediate requests.
31+
32+
### Cloud Optimized GeoTIFF
33+
34+
A [Cloud Optimized GeoTIFF (COG)](https://www.cogeo.org) is a raster TIFF file with an internal organization that enables remote reads from cloud storage. PMTiles is similar to COG, but stores arbitrary tiled data, such as vector MVT tiles. However, COG is backwards compatible with most GIS software that deals with GeoTIFF.
35+
2036
## Reading PMTiles
2137

2238
### PMTiles Viewer
@@ -44,9 +60,11 @@ See the [pmtiles cli](/pmtiles/cli).
4460

4561
### JavaScript
4662

47-
PMTiles is designed for being read directly in web browsers in conjunction with a JavaScript map library.
63+
PMTiles is designed for being viewed directly in web browsers in conjunction with a JavaScript map rendering library, including:
4864

49-
See the docs on viewing PMTiles in [Leaflet](/pmtiles/leaflet), [MapLibre GL JS](/pmtiles/maplibre) and [OpenLayers](/pmtiles/openlayers).
65+
* [MapLibre GL JS](/pmtiles/maplibre) - the recommended library for building smooth experiences and custom styling.
66+
* [Leaflet](/pmtiles/leaflet) - a lightweight map display library with many plugins.
67+
* [OpenLayers](/pmtiles/openlayers) - has the most GIS-related features.
5068

5169
Each of the client integrations uses the [JavaScript pmtiles library](https://github.com/protomaps/PMTiles/tree/main/js).
5270

@@ -65,3 +83,4 @@ The Python `pmtiles` package should be considered beta status.
6583
These libraries are maintained by other individuals and organizations.
6684

6785
* Dart: [pub.dev/packages/pmtiles](https://pub.dev/packages/pmtiles)
86+
* Rust: [stadiamaps/pmtiles-rs](https://github.com/stadiamaps/pmtiles-rs)

0 commit comments

Comments
 (0)