Quarry - Downloads

About the Tile Formats

📦 PMTiles

A cloud-optimized single-file archive format. Tiles can be served directly via HTTP range requests without a tile server - just host on any static file server, S3, or CDN.

Smaller file size (~30% smaller than MBTiles)
No server required - works with static hosting
Supported by MapLibre GL JS via protocol handler
Ideal for web applications and CDN distribution

→ Preview in 2D Viewer

🗄️ MBTiles

SQLite-based tile archive format, widely supported by existing tile servers and GIS tools. The industry standard format used by MapTiler, TileServer GL, and many others.

Universal compatibility with tile servers
Direct support in QGIS, MapTiler, TileServer GL
Can be queried with standard SQLite tools
Ideal for self-hosted tile servers

→ Preview in MBTiles Viewer

Compatibility

OpenStreetMap Schema

Tiles are generated using Planetiler with the Protomaps Basemap schema. This schema is optimized for web mapping and includes layers for water, land use, roads, buildings, places, and boundaries derived from OpenStreetMap data.

Vector layers: earth, water, landuse, roads, buildings, places, boundaries, pois

MapTiler / TileServer GL

MBTiles files are fully compatible with TileServer GL and can be used with MapTiler Desktop for styling and hosting. The tiles use gzip-compressed PBF format (Mapbox Vector Tiles specification).

Note: The layer schema differs from OpenMapTiles. If using existing OpenMapTiles styles, you'll need to adapt the layer names (e.g., transportation → roads).

Syncing Data

Tiles are rebuilt daily from the latest OpenStreetMap planet file. Use these methods to keep your local copy in sync.

Use rsync for efficient incremental syncing. Only changed blocks are transferred.

                    # Sync the current/latest build
rsync -avzP --progress rsync://www.quarrymapserver.com/tiles/current/ ./tiles/

# Sync a specific dated build
rsync -avzP --progress rsync://www.quarrymapserver.com/tiles/2026-01-21/ ./tiles/2026-01-21/

# Sync only PMTiles files (exclude MBTiles)
rsync -avzP --include='*.pmtiles' --exclude='*.mbtiles' \
    rsync://www.quarrymapserver.com/tiles/current/ ./tiles/
                

Mirror files with wget. Supports resumable downloads for large files.

                    # Download current planet tiles (resumable)
wget -c -P ./tiles/ http://www.quarrymapserver.com/downloads/current/planet.pmtiles

# Mirror entire build directory
wget -m -np -nH --cut-dirs=2 -P ./tiles/ \
    http://www.quarrymapserver.com/downloads/current/

# Verify download integrity
wget -O - http://www.quarrymapserver.com/downloads/current/checksums.sha256 | sha256sum -c
                

Use the API to check for new builds and automate your sync workflow.

                    # Check current build date
curl -s http://www.quarrymapserver.com/api/current | jq .date

# List all available builds
curl -s http://www.quarrymapserver.com/api/builds | jq '.[].date'

# Get build metadata
curl -s http://www.quarrymapserver.com/api/builds | jq '.[] | select(.isCurrent)'

# Check build status (for automation)
curl -s http://www.quarrymapserver.com/api/status | jq .status
                

Usage Examples

PMTiles can be served directly from cloud storage or locally with HTTP range request support.

                    // MapLibre GL JS with PMTiles
import { Protocol } from 'pmtiles';
import maplibregl from 'maplibre-gl';

const protocol = new Protocol();
maplibregl.addProtocol('pmtiles', protocol.tile);

const map = new maplibregl.Map({
    container: 'map',
    style: {
        version: 8,
        sources: {
            protomaps: {
                type: 'vector',
                url: 'pmtiles://path/to/planet.pmtiles'
            }
        },
        layers: [/* your layers */]
    }
});
                

MBTiles can be served with TileServer GL or other tile servers.

                    # Install TileServer GL
npm install -g @maptiler/tileserver-gl

# Serve your tiles
tileserver-gl planet.mbtiles

# Access at http://localhost:8080
                

Download files with resumable support using curl or wget.

                    # Download with curl (resumable)
curl -C - -O http://your-server:8080/downloads/2025-01-20/planet.pmtiles

# Download with wget (resumable)
wget -c http://your-server:8080/downloads/2025-01-20/planet.pmtiles

# Verify checksum
sha256sum -c checksums.sha256
                