openEO - Concepts and API Reference¶
Note: The specification is currently still an early version, with the potential for some major things to change. The core is now fleshed out, so everybody is encouraged to try it out and give feedback (for example by adding issues). But the goal is to actually be able to act on that feedback, which will mean changes are quite possible.
- open: used here in the context of open source software; open source software is available in source code form, and can be freely modified and redistributed; the openEO project will create open source software, reusable under a liberal open source license (Apache 2.0)
- EO: Earth observation
Jointly, the openEO targets the processing and analysis of Earth observation data. The main objectives of the project are the following concepts:
- Unification: current EO cloud back-ends all have a different API, making EO data analysis hard to validate and reproduce and back-ends difficult to compare in terms of capability and costs, or to combine them in a joint analysis across back-ends. A unified API can resolve many of these problems.
The following pages introduce the core concepts of the project. Make sure to introduce yourself to the major technical terms used in the openEO project by reading the glossary.
The openEO API defines a HTTP API that lets cloud back-ends with large Earth observation datasets communicate with front end analysis applications in an interoperable way. This documentation describes important API concepts and design decisions and gives a complete API reference documentation.
As an overview, the openEO API specifies how to
- discover which Earth observation data and processes are available at cloud back-ends,
- execute (chained) processes on back-ends,
- run user-defined functions (UDFs) on back-ends where UDFs can be exposed to the data in different ways,
- download (intermediate) results, and
- manage user content including billing.
The API is defined as an OpenAPI 3.0 JSON file.
openEO, A Common, Open Source Interface between Earth Observation Data Infrastructures and Front-End Applications is a H2020 project funded under call EO-2-2017: EO Big Data Shift, under proposal number 776242. It will run from Oct 2017 to Sept 2020.
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 776242. The contents of this website reflects only the authors’ view; the European Commission is not responsible for any use that may be made of the information it provides.