Skip to content

Commit

Permalink
OGC API - Coverages: a few more details from after testbed-19 call.
Browse files Browse the repository at this point in the history
  • Loading branch information
pierocampa committed Jun 28, 2023
1 parent 67904e5 commit 7036816
Showing 1 changed file with 13 additions and 12 deletions.
25 changes: 13 additions & 12 deletions crosswalks/ogcapi-coverages.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This document gives a brief overview over similarities and differences between

**TABLE OF CONTENTS**

[TOC]
[TOC_]

## Introduction

Expand Down Expand Up @@ -257,7 +257,9 @@ or by reference to an external file which may have any suitable encoding.

**openEO** provides access to the actual data by means of the
[load_collection](https://processes.openeo.org/#load_collection) process, which can
be submitted either synchronously or asynchronously as a batch job.
be submitted either synchronously, or asynchronously as a batch job.
The format of the resulting data shall always be specified by chaining a
[save_result](https://processes.openeo.org/#save_result) process.

For pre-filtering / data subsetting options, see next section.

Expand Down Expand Up @@ -354,7 +356,7 @@ for via query parameters of the URL.

### Tiles

- openEO: `n/a` (?)
- openEO: `n/a`

- OAC1:
- `GET /collections/{collectionId}/coverage/tiles` : list the available tilesets
Expand All @@ -367,25 +369,24 @@ coverage data in form of tiles, hence trimmed and resampled to match the
boundaries and resolution of a given tile. More than one tilesets can be attached to a coverage.

**openEO** does not provide tiled access directly, but can be easily cascaded to
a dedicated secondary tile service (like [XYZ tiles](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames))
thanks to the [`/service_types`](https://api.openeo.org/1.2.0/#tag/Capabilities/operation/list-service-types) resource. (?)
a dedicated secondary tiles service (like [XYZ tiles](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames))
thanks to the [`/service_types`](https://api.openeo.org/1.2.0/#tag/Capabilities/operation/list-service-types) resource.


### Media encoding

- openEO: [`GET /file_formats`](https://api.openeo.org/1.2.0/#tag/Capabilities/operation/list-file-types)

- OAC1: `GET /` (?)
- OAC1: `GET /api`

While not exposed as a dedicated API resource, **OAC1** requires a server to provide information about
the supported media types (probably in the landing page).
Both **OAC1** and **openEO** provide a list of data formats the server supports, both
the data formats the server can read from (input), and write to (output).

**OAC1** does not mandate any particular output encoding or format, although CIS JSON is recommended.
**OAC1** embeds the information in the API description available in the `/api` endpoint.
It does not mandate any particular output encoding or format, although CIS JSON is recommended.
Binary formats of course are also alllowed (CIS RDF, NetCDF, GeoTIFF, PNG, JPEG, JPEG-2000, etc.)

**openEO** returns a list of data formats the server supports, with the additional
information of the data formats the server can also read from (input), and not just
write to (output). Format names and parameters are aligned with the GDAL/OGR formats although
In **openEO** format names and parameters are aligned with the GDAL/OGR formats although
custom file formats are also permitted.


Expand Down

0 comments on commit 7036816

Please sign in to comment.