pygeoapi logo

DOI

pygeoapi is a Python server implementation of the OGC API suite of standards. The project emerged as part of the next generation OGC API efforts in 2018 and provides the capability for organizations to deploy a RESTful OGC API endpoint using OpenAPI, GeoJSON, and HTML. pygeoapi is open source and released under an MIT license.
Certified OGC Compliant OGC Reference Implementation OGC Reference Implementation OGC Reference Implementation OGC Reference Implementation OSGeo ProjectFOSS4G ConferenceSponsorship

Install in 5 minutes

# Python 3.10 required
python3 -m venv pygeoapi
cd pygeoapi
. bin/activate
git clone https://github.com/geopython/pygeoapi.git
cd pygeoapi
pip3 install -r requirements.txt
python3 setup.py 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

Features

At a glance:

  • Easy to install: install a full implementation via pip or git
  • Easy to deploy: via UbuntuGIS or the official Docker image
  • Flexible: built on a robust plugin framework
    • connect to custom data sources (files, services, databases, etc.)
    • serve custom output formats
    • implement custom processes and workflows
    • deploy via Flask, Django, or any Python framework
  • OGC Compliant: pygeoapi is certified OGC Compliant and an OGC Reference Implementation