An OGC API to geospatial data

OSGeo Project FOSS4G 2022 Florence

This presentation available at

Table of contents

  • Project overview
  • Core capabilities
  • Latest developments
  • Selected featured projects
  • Roadmap
  • Support

Project overview

Project overview

Project Overview

  • Geospatial data Web API framework via OGC API
  • REST/JSON/OpenAPI/Swagger
  • OGC Compliant
  • OSGeo Project
  • International team (Canada, Netherlands, Greece, Italy, New Zealand, United States, Spain)
    • Numerous core contributors
    • 21000 upstream contributors (dependencies)

Install in 5 minutes

python3 -m venv pygeoapi
cd pygeoapi
. bin/activate
git clone
cd pygeoapi
pip3 install -r requirements.txt
python3 install
cp pygeoapi-config.yml example-config.yml
vi example-config.yml  # edit as required
export PYGEOAPI_CONFIG=example-config.yml
export PYGEOAPI_OPENAPI=example-openapi.yml
pygeoapi openapi generate $PYGEOAPI_CONFIG --output-file $PYGEOAPI_OPENAPI
pygeoapi serve
# in another terminal
curl http://localhost:5000  # or open in a web browser

Technical Overview

  • Core abstract API; web framework agnostic (default Flask)
  • YAML configuration (metadata, dataset connections)
  • Automated OpenAPI document generation and data binding
  • Robust plugin framework (data connections, formats, processing)
  • Easy deployment (pip install, Docker, conda, UbuntuGIS)
  • Minimal core dependencies

Provider plugin framework

  • Features (Elasticsearch, PostgreSQL/PostGIS, CSV, GeoJSON, OGR, MongoDB, Esri)
  • Coverages (xarray, rasterio)
  • Tiles (MinIO, ZXY directory tree)
  • Records (Elasticsearch, TinyDB)
  • Implement your own!

Processing framework

  • Expose Python workflow as processes
  • Process manager support for job control (TinyDB)
  • Implement your own!

Implementing your own Plugin

  • Develop / propose / maintain as core plugin
  • Develop / maintain in your own repository

  • Lower the barrier to data search
  • HTML encoding is annotated as to facilitate search engines
  • Google dataset search locates pygeoapi datasets

Linked Data - JSON-LD

  • JSON-LD provided as additional representation
  • Default out of the box functionality for most pygeoapi resources / endpoints
  • Additional configuration


Numerous deployment options

  • PyPI
  • UbuntuGIS
  • Docker
  • Conda
  • FreeBSD

Core Capabilities


OGC API - Features

OGC API - Coverages

OGC API - Records

OGC API - Tiles

OGC API - Processes

OGC API - Environmental Data Retrieval

SpatioTemporal Asset Catalog (STAC)

HTML templating

Latest developments


OGC API sprint participation

  • Leading/following implementation
  • Rapid/early adoption of specifications/update
  • Experimentation (servers, clients)
  • OGC/OSGeo/ASF Joint Sprint (March 2022)
  • Collaboration
    • OSGeo projects
    • OGC API implementing clients/servers

OGC API - Routes Implementation

New core committers

Welcome Joana Simoes, Ph.D (@doublebyte)

  • Developer Relations, OGC
  • Long time contributor to FOSS4G
  • OSGeo Charter member circa 2017
  • Vice-president OSGeo Portugal Local Chapter
  • pygeoapi: OGC API Sprints, Features, Tiles, MongoDB, Elasticsearch

New core committers

Welcome Ben Webb (@webb-ben)

  • Lincoln Institute of Land Policy
  • Center for Geospatial Solutions
  • US Internet of Water
  • pygeoapi: Provider plugins

Service providers

  • training
  • setup/installation/deployment
  • custom integration
  • bug fixing
  • features/enhancements
  • core development
  • maintenance/packaging/distribution
  • documentation

Hierarchical collections


More new features

  • HTML: migration to Bootstrap
  • Hidden resource publication (publishing without advertising)
  • New provider plugins: (Esri, Socrata, STAC HATEOAS)
  • Anti-meridian support
  • Gzip support

Selected recent projects

WIS2 in a box


  • US Geospatial Platform (Geoplatform) provides a central point of access to federal geospatial metadata, services and data
  • Aligns with FAIR principles
  • Powered by numerous FOSS4G components
  • Aligns with FAIR principles
  • 100+ National Geospatial Data Assets


  • Mapping the cities through the senses of those who make them
  • Urban living and mental health and wellbeing

British Geological Survey - OGCAPI Server

  • BGS OpenGeoscience geospatial data


  • A Geospatially Enabled Ecosystem for Europe
  • Data integration platform demonstrating how vital connections between existing and emerging national, regional, and cross-border digital services can be made

  • The Geoconnex project is about providing technical infrastructure and guidance to create an open, community-contribution model for a knowledge graph linking hydrologic features in the United States, published in accordance with Spatial Data on the Web best practives as an implementation of Internet of Water principles

River Runner



  • 1.0
    • OGC API - Maps
    • OGC API - Styles
    • API Refactor
  • Transactions
  • Google BigQuery provider plugin



Thank you!


@tomkralidis @JMendesDeJesus @justb4 @pvgenuchten @tzotsos @alpha-beta-soup @francbartoli @doublebyte