Skip to content
master
Switch branches/tags
Code

OGC API - Processes

This GitHub repository contains the OGC API - Processes for processing geospatial information on the web. It focuses on a simple RESTful core specified as reusable OpenAPI components with responses in JSON and HTML.

OGC API standards define modular API building blocks to spatially enable Web APIs in a consistent way. OpenAPI is used to define the reusable API building blocks.

Overview

The OGC API - Processes enables the execution of computing processes and the retrieval of metadata describing their purpose and functionality. Typically, these processes combine raster, vector, and/or coverage data with well-defined algorithms to produce new raster, vector, and/or coverage information.

GET /processes

Lists the processes this API offers.

GET /processes/{process-id}

Returns a detailed description of a process.

GET /jobs

Returns the running and finished jobs for a process (optional).

POST /processes/{process-id}/execution

Executes a process, i.e. creates a new job. Inputs, outputs and the process id will have to be specified in a JSON document that needs to be send in the POST body.

GET /jobs/{job-id}

Returns the status of a job of a process.

DELETE /jobs/{job-id}

Cancel a job execution.

GET /jobs/{job-id}/results

Returns the result of a job of a process.

Using the standard

A draft of the OGC API - Processes is available:

Several implementations of the draft standard exist:

Implementations of the draft specification / demo services

Contributing

The contributor understands that any contributions, if accepted by the OGC Membership, shall be incorporated into OGC API - Processes standards documents and that all copyright and intellectual property shall be vested to the OGC.

The OGC API - Processes Standards Working Group (SWG) is the group at OGC responsible for the stewardship of the standard, but is working to do as much work in public as possible.

Pull Requests from contributors are welcomed. However, please note that by sending a Pull Request or Commit to this GitHub repository, you are agreeing to the terms in the Observer Agreement https://portal.ogc.org/files/?artifact_id=92169