pmtiles-CLI-Referenz

pmtiles show

$ pmtiles show FILE.pmtiles

gibt die Header-Informationen und Metadaten eines lokalen Archivs aus.

$ pmtiles show https://maps.cusy.io/map.pmtiles

gibt die Header-Informationen und Metadaten eines entfernten HTTPS-Archivs aus.

$ pmtiles show FILE.pmtiles --bucket=s3://BUCKET

gibt die Header-Informationen und Metadaten eines Archivs aus, das sich auf einem S3-kompatiblen Bucket befindet.

$ pmtiles show FILE.pmtiles --header-json

gibt eine JSON-Repräsentation des Headers aus.

$ pmtiles show FILE.pmtiles --metadata

gibt die JSON-Metadaten aus.

Bemerkung

URLs mit Zeichen wie ? und &, sollten mit einem Backslash \ escaped werden.

pmtiles tile

$ pmtiles tile FILE.pmtiles 0 0 0

gibt den Inhalt einer einzelnen Kachel aus.

pmtiles verify

$ pmtiles verify FILE.pmtiles

überprüft, ob ein Archiv richtig geordnet ist und korrekte Header-Informationen enthält.

pmtiles extract

$ pmtiles extract

erstellt ein kleineres Archiv aus einem größeren, wobei da Quellarchiv geclustert sein muss:

$ pmtiles extract IN.pmtiles OUT.pmtiles --bbox=MIN_LON,MIN_LAT,MAX_LON,MAX_LAT

Den Begrenzungsrahmen mit MIN_LON, MIN_LAT, AX_LON und MAX_LAT könnt ihr z.B. mit bboxfinder.com ermitteln.

$ pmtiles extract IN.pmtiles OUT.pmtiles --region=REGION.geojson

Mit --region kann ein GeoJSON Polygon-, Multipolygon-, Feature- oder ein FeatureCollection-Objekt angegeben werden.

$ pmtiles extract https://EXAMPLE.COM/IN.pmtiles OUT.pmtiles --maxzoom=MAXZOOM --download-threads=4

--maxzoom extrahiert nur eine Teilmenge der Zoomstufen.

--download-threads gibt die Anzahl der parallelen Anfragen zur Beschleunigung der Downloads an.

$ pmtiles extract IN.pmtiles OUT.pmtiles --maxzoom=MAXZOOM --bucket=s3://BUCKET

Weitere Optionen sind:

--minzoom

extrahiert nur einen Teil der Pyramide, was jedoch viel mehr Anfragen erfordern kann als die Standardeinstellung --minzoom=0. Da dies die Übersichts-Zoomstufen entfernt, sollte es nur in bestimmten Situationen verwendet werden.

--overfetch

läd zusätzliche Daten herunter, um kleine Anfragen zu bündeln: 0.05 entspricht 5 %.

pmtiles serve

$ pmtiles serve

ist ein einfacher Weg, PMTiles zusammen mit pmtiles.js im Web bereitzustellen:

$ pmtiles serve PATH

liefert eine TILESET.pmtiles-Datei aus dem Verzeichnis PATH unter der URL http://localhost:8080/TILESET/Z/X/Y.mvt|png|jpg|webp|avif aus, wobei der Suffix dem Kacheltyp im Archiv entsprechen muss.

$ pmtiles serve . --public-url=localhost

erlaubt die Ausgabe von TileJSON unter der URL http://localhost:8080/TILESET.json.

pmtiles convert

$ pmtiles convert

konvertiert ein MBTiles-Archiv in PMTiles:

$ pmtiles convert IN.mbtiles OUT.pmtiles

--no-deduplication

Kachelinhalte sollten üblicherweise de-dupliziert werden. Verwendet dies nur, wenn ihr wisst, dass die Eingabe nur einzigartige Kacheln enthält und die Konvertierung beschleunigt werden soll.

--tmpdir

erlaubt die Angabe des temporären Verzeichnisses.

pmtiles cluster

pmtiles cluster IN.pmtiles

clustert ein bestehendes Archiv, wobei die Größe und das Layout optimiert werden. Mit tippecanoe, planetiler und pmtiles CLI erstellte Archive sind bereits geclustert.

--no-deduplication

Kachelinhalte sollten üblicherweise de-dupliziert werden. Verwendet dies nur, wenn ihr wisst, dass die Eingabe nur einzigartige Kacheln enthält und die Konvertierung beschleunigt werden soll.

pmtiles upload

pmtiles upload IN.pmtiles REMOTE.pmtiles --bucket=s3://BUCKET

lädt ein Archiv in den Cloud-Speicher hoch.

pmtiles edit

pmtiles edit NAME.pmtiles --header-json=HEADER.json --metadata=METADATA.json

ändert Teile des Archiv-Headers, oder ersetzt die JSON-Metadaten des Archivs. Wenn ihr nur den Header bearbeitet, wird die Datei an Ort und Stelle geändert; das Schreiben der JSON-Metadaten erfordert jedoch das Schreiben einer neuen Kopie des Archivs, die dann NAME.pmtiles ersetzt.

Hinweis

Ihr könnt die bestehenden Header-Informationen und Metadaten in die Dateien HEADER.json und METADATA.json schreiben mit:

pmtiles show NAME.pmtiles --header-json > HEADER.json

bzw.

pmtiles show NAME.pmtiles --metadata > METADATA.json

Hinweis

Die Felder tile_type, tile_compresssion, minzoom, maxzoom, bounds und center des Headers können bearbeitet werden; andere Felder sind jedoch nicht bearbeitbar.

pmtiles version

pmtiles version

gibt die Version von pmtiles aus.