Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Pmtiles concepts comparisons + tilemaker updates #91

Merged
merged 2 commits into from
Dec 25, 2024
Merged

Pmtiles concepts comparisons + tilemaker updates #91

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c8bb0b2
add to PMTiles concepts page
bdon Dec 25, 2024
a44b21e
update pmtiles create section on tilemaker
bdon Dec 25, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion pmtiles/create.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,4 +70,4 @@ Run the basemaps program on your own computer to modify the layers or generate o

## Tilemaker

[Tilemaker](https://github.com/systemed/tilemaker) is a program for creating basemap tilesets from OpenStreetMap, though not ones that match the layers in the Protomaps [Basemap Layers](/basemaps/layers). Currently it is recommended only for small areas since the PMTiles index structure is not as optimized as the [Protomaps basemaps](#protomaps/basemaps) generation tool.
[Tilemaker](https://github.com/systemed/tilemaker) is a program for creating basemap tilesets from OpenStreetMap, though not ones that match the layers in the Protomaps [Basemap Layers](/basemaps/layers). The PMTiles directories that Tilemakers produces are currently not optimized, which may result in large, slower fetches when decoding in a web browser. An alternative is to create MBTiles from Tilemaker and then use `pmtiles convert`.
23 changes: 21 additions & 2 deletions pmtiles/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,24 @@ PMTiles is a single-file archive format for pyramids of tiled data. A PMTiles ar

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

* 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).

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)

## Comparisons

### Individual files

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.

### MBTiles

[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.

### Cloud Optimized GeoTIFF

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.

## Reading PMTiles

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

### JavaScript

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

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

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

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

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