You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pmtiles/index.md
+21-2Lines changed: 21 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -15,8 +15,24 @@ PMTiles is a single-file archive format for pyramids of tiled data. A PMTiles ar
15
15
16
16
* The arrangement of tiles and directories is designed to minimize the amount of overhead requests when panning and zooming.
17
17
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
+
18
20
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)
19
21
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
+
20
36
## Reading PMTiles
21
37
22
38
### PMTiles Viewer
@@ -44,9 +60,11 @@ See the [pmtiles cli](/pmtiles/cli).
44
60
45
61
### JavaScript
46
62
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:
48
64
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.
50
68
51
69
Each of the client integrations uses the [JavaScript pmtiles library](https://github.com/protomaps/PMTiles/tree/main/js).
52
70
@@ -65,3 +83,4 @@ The Python `pmtiles` package should be considered beta status.
65
83
These libraries are maintained by other individuals and organizations.
0 commit comments