Publishing tiles to OGC API - Tiles

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

pygeoapi can publish tiles from local or remote data sources (including cloud object storage or a tile service). 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):

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.

Remote data sources can be any external service (i.e. Elasticsearch), by providing a URL template.

Note

Currently, the URL templating in this provider supports the following formats: /{z}/{x}/{y} or /{z}/{y}/{x}. For additional formats: feel free to file an issue.

This code block shows how to configure pygeoapi to read Mapbox vector tiles, from disk or a URL.

providers:
    - type: tile
      name: MVT
      data: tests/data/tiles/ne_110m_lakes  # local directory tree
      # data: http://localhost:9000/ne_110m_lakes/{z}/{x}/{y}.pbf # tiles stored on a MinIO bucket
      options:
          metadata_format: default # default | tilejson
          zoom:
              min: 0
              max: 5
          schemes:
              - WorldCRS84Quad
      format:
          name: pbf
          mimetype: application/vnd.mapbox-vector-tile

This code block shows how to configure pygeoapi to read Mapbox vector tiles, from an Elasticsearch endpoint.

providers:
    - type: tile
      name: MVT
      data: http://localhost:9200/ne_110m_populated_places_simple2/_mvt/geometry/{z}/{x}/{y}?grid_precision=0
      # if you don't use precision 0, you will be requesting for aggregations which are not supported in the
      # free version of elastic
      options:
          metadata_format: default # default | tilejson
          zoom:
              min: 0
              max: 5
          schemes:
              - WorldCRS84Quad
      format:
          name: pbf
          mimetype: application/vnd.mapbox-vector-tile

This code block shows how to configure pygeoapi to read Mapbox vector tiles, from a pg_tileserv endpoint.

providers:
    - type: tile
      name: MVT
      data: http://localhost:7800/public.ne_50m_admin_0_countries/{z}/{x}/{y}.pbf
      options:
        metadata_format: default # default | tilejson
        zoom:
            min: 0
            max: 16
        schemes:
            - WorldCRS84Quad
      format:
            name: pbf
            mimetype: application/vnd.mapbox-vector-tile

Data access examples