ogcapi-tiles.rst

Publishing map tiles to OGC API - Tiles

OGC API - Tiles provides access to geospatial data in the form of tiles (map, vector, etc.).

pygeoapi can publish tiles from local or remote data sources (including cloud object storage). To integrate tiles from a local data source, it is assumed that a directory tree of static tiles has been created on disk. Examples of tile generation software include (but are not limited to):

• MapProxy
• tippecanoe

Providers

pygeoapi core tile providers are listed below, along with supported storage types.

Provider	local	remote
MVT	✅	✅

Below are specific connection examples based on supported providers.

Connection examples

MVT

The MVT provider plugin provides access to Mapbox Vector Tiles.

providers:
    - type: tile
      name: MVT 
      data: tests/data/tiles/ne_110m_lakes  # local directory tree
      # data: https://example.org/ne_110m_lakes/{z}/{x}/{y}.pbf
      options:
          metadata_format: raw # default | tilejson
          zoom:
              min: 0
              max: 5
          schemes:
              - WorldCRS84Quad
      format:
          name: pbf 
          mimetype: application/vnd.mapbox-vector-tile

Data access examples

• list all collections
  • http://localhost:5000/collections
• overview of dataset
  • http://localhost:5000/collections/foo
• overview of dataset tiles
  • http://localhost:5000/collections/foo/tiles
• tile matrix metadata
  • http://localhost:5000/collections/lakes/tiles/WorldCRS84Quad/metadata
• tiles URI template
  • http://localhost:5000/collections/lakes/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}?f=mvt