Francesco Bartoli
4f52536051
* Add ogc api tiles implementation * Add json response to tiles endpoint * Return correct json payload * Fix url generation * Add vector tile layer with clickable items * Fix typo * Fix oafeat collection tiles link * Add format to metadata link * Fix almost all flake8 errors * Fix metadata link * Add routes to serving tiles * Refactor tile implementation with an own module * Add http client for mvt * Fix visibility of tiles template * Fix tiles in collection item page * Change source to data coherently with stac provider * Fix flake8 errors * Fix test for conformance classes * Fix flake8 errors Fix flake8 errors * Refactor to align with new configuration structure * Fix MVT plugin name * Add openapi tiles path and schemas * Add ogc api tiles implementation * Add json response to tiles endpoint * Return correct json payload * Fix url generation * Add vector tile layer with clickable items * Fix typo * Fix oafeat collection tiles link * Add format to metadata link * Fix almost all flake8 errors * Fix metadata link * Add routes to serving tiles * Refactor tile implementation with an own module * Add http client for mvt * Fix visibility of tiles template * Fix tiles in collection item page * Change source to data coherently with stac provider * Fix flake8 errors * Fix test for conformance classes * Fix flake8 errors Fix flake8 errors * Refactor to align with new configuration structure * Fix MVT plugin name * Add openapi tiles path and schemas * Fix flake errors * Fix merge and tests * Add test configuration and data for tiles * Change mapbox vector tile provider name * Fix provider inspection and filter * Fix tiles rendering in collection page * Add mimetype to the mvt provider * Fix mimetype * Rename functions accordingly to singular and plural forms * Fix tiling schemes in tiles template * Serve mvt through the pygeoapi route * Refactor and add test for collection tiles * Fix test for not being tiles * Remove httpx dependency * Fix missing comma * Fix tests * Fix flake8 * Add initial metadata implementation * Fix route with preprocess * Fix tiles template Fix tiles template * Complete tileset api and template * Fix flake8 * Complete metadata with tilejson response * Add support for local vector tiles * Fix flake8 * Fix plugin tile object and provider name * Add a todo comment * testing alternate plugin setup, fix some HTML, add OpenAPI endpoint * remove URI template * add docs * Fix failing test * Fix flake8 error Co-authored-by: Francesco Bartoli <francesco.bartoli@wfp.org> Co-authored-by: Tom Kralidis <tomkralidis@gmail.com>
52 lines
2.3 KiB
ReStructuredText
52 lines
2.3 KiB
ReStructuredText
.. _introduction:
|
|
|
|
Introduction
|
|
============
|
|
|
|
`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 <https://opensource.org>`_ and released under an MIT :ref:`license`.
|
|
|
|
Features
|
|
--------
|
|
|
|
- out of the box modern OGC API server
|
|
- certified OGC Compliant and Reference Implementation for OGC API - Features
|
|
- additionally implements OGC API - Coverages, OGC API - Tiles, OGC API - Processes and SpatioTemporal Asset Library
|
|
- out of the box data provider plugins for rasterio, GDAL/OGR, Elasticsearch, PostgreSQL/PostGIS
|
|
- easy to use OpenAPI / Swagger documentation for developers
|
|
- supports JSON, GeoJSON, HTML and CSV output
|
|
- supports data filtering by spatial, temporal or attribute queries
|
|
- easy to install: install a full implementation via ``pip`` or ``git``
|
|
- simple YAML configuration
|
|
- easy to deploy: via UbuntuGIS or the official Docker image
|
|
- flexible: built on a robust plugin framework to build custom data connections, formats and processes
|
|
- supports any Python web framework (included are Flask [default], Starlette)
|
|
|
|
Standards Support
|
|
-----------------
|
|
|
|
Standards are at the core of pygeoapi. Below is the project's standards support matrix.
|
|
|
|
- Implementing: implements standard (good)
|
|
- Compliant: conforms to OGC compliance requirements (great)
|
|
- Reference Implementation: provides a reference for the standard (awesome!)
|
|
|
|
.. csv-table::
|
|
:header: "Standard", "Support"
|
|
:align: left
|
|
:widths: 20, 20
|
|
|
|
`OGC API - Features`_,Reference Implementation
|
|
`OGC API - Coverages`_,Implementing
|
|
`OGC API - Tiles`_,Implementing
|
|
`OGC API - Processes`_,Implementing
|
|
`SpatioTemporal Asset Catalog`_,Implementing
|
|
|
|
|
|
.. _`pygeoapi`: https://pygeoapi.io
|
|
.. _`OGC API`: https://ogcapi.ogc.org
|
|
.. _`OGC API - Features`: https://www.ogc.org/standards/ogcapi-features
|
|
.. _`OGC API - Coverages`: https://github.com/opengeospatial/ogc_api_coverages
|
|
.. _`OGC API - Tiles`: https://github.com/opengeospatial/OGC-API-Tiles
|
|
.. _`OGC API - Processes`: https://github.com/opengeospatial/wps-rest-binding
|
|
.. _`SpatioTemporal Asset Catalog`: https://stacspec.org
|