PMTiles Reader/Writer

FME reads and writes from PMTiles. PMTiles is a single-file archive format for storing Mapbox Vector Tiles (MVT), designed to work efficiently with cloud storage and the web.

Tiles contain geometries that contain compressed vector tile data conforming to the MVT specification.

Version Support

FME supports reading and writing .pmtiles files for both versions 2.x and 3.x. However, support is limited to files that contain Mapbox Vector tiles; raster tiles are not supported.

Product and System Requirements

Format

FME Platform

Operating System

Reader/Writer

FME Form

FME Flow

FME Flow Hosted

Windows 64-bit

Linux

Mac

Reader

Yes

Yes

Yes

Yes

Yes

Yes

Writer

Yes

Yes

Yes

Yes

Yes

Yes

Reader Overview

The reader processes data from both local and remote .pmtiles files, containing vector tiles encoded in the Mapbox Vector Tile (MVT) format. Each tile may contain any number of vector features of any supported geometry type, which then become features in FME.

FME considers a single PMTiles file to be a dataset and prefers files with the .pmtiles extension. The file must contain the JSON metadata conforming to the MBTiles specification which contains at a minimum the vector_layers array to be valid for reading with the PMTiles reader.

Users can select subsets of data based on a spatial envelope and/or a specific zoom level.

Dataset

The dataset can be a PMTiles file with extension .pmtiles, or it can be a URL address to a file (for example, http[s]://path/to/some.pmtiles.

See Usage Notes for further information.

Writer Overview

The writer can write vector geometry and user attributes to a local .pmtiles file.

The PMTiles writer accepts input vector features from various layers and writes them as tiled data to a .pmtiles file at user-specified zoom levels for each layer. Tiles will always be generated in WebMercator (EPSG:3857) projection.

The PMTiles writer supports additional options through writer parameters and feature type parameters.

Usage Notes

  • This reader supports reading PMTiles archives containing vector tile data (Mapbox Vector Tile format).
  • Each layer in the vector tile corresponds to its own feature type. A Tile may have multiple layers, and therefore multiple feature types.

Terminology

Definition or FME Representation

PMTiles Equivalent

reader or writer dataset

tileset

feature type

layer

attribute

field/attribute