[Requests] Comment / Question on OGC API-Common (19-072)

Uwe Voges, Dr. - con terra GmbH u.voges at conterra.de
Tue Mar 10 05:33:21 EDT 2020


Part A to be completed once.  Iterate Part B as needed.


PART A


1. Evaluator:
        [Uwe Voges, con terra, Germany]

2. Submission: [OGC API-Common (19-072)]



PART B


1. Requirement: [General, Requirement 11,...]


2. Implementation Specification Section number: [9.2.1]


3. Criticality: [Major]


4. Comments/justifications for changes: [Comments]

I was wondering how the use case will be covered that there may be hierarchies of collections (see also STAC) ?
This will include the case that some hierarchy levels may be searchable for items (records) while others may not ...
Example:

Meteosat Catalogue (Searchable for all Meteosat products)
             MTG (Searchable just for MTG products)
             MSG (Searchable just for MSG)
Metop Catalogue (Searchable for all Metop products)
             EPS (Searchable for EPS products)
             EPS-SG (Searchable for EPS-SG products)
Sentinel Catalogue (not searchable)
             Sentinel3 Catalogue (Searchable for Sentinel3 products)

Ok, one idea could be to provide different API´s with an own landing page etc for every hierarchyLevel....

Another option could be to have the /collections resource which may not even return links to single collections (/collection) but also links to other hierarchy levels of collections (/collections) (rel="collections" like the rel "data" in the landing page).

I tried ad hoc a JSON encoding of the example above which could be provided by the link from the landing page (rel="data") (just a few metadata elements considered here):

{
  "collections": [
     {
      "id": "msgCat",
      "type": "catalogue",
      "title": "Meteosat Catalogue",
      "links": [
        {
          "href": "http://.../meteosatCat/collections",
          "rel": "collections",
          "title": "At this endpoint you can retrieve hypermedia controls that allow you to navigate sub-collections, e.g. MTG, MSG. Here you can retrieve descriptions of these sub-catalogues as well as hypermedia controls that allow you to query the sub-catalogues"
        },
        {
          "href": "http://.../meteosatCat/collections/meteosat",
          "rel": "collection",
          "title": "At this endpoint you can retrieve a description of this catalogue as well as hypermedia controls that allow you to query the catalogue."
        }
      ]
   },
   {
      "id": "metopCat",
      "type": "catalogue",
      "title": "Metop Catalogue",
      "links": [
        {
          "href": "http://.../metopCat/collections",
          "rel": "collections",
          "title": "At this endpoint you can retrieve hypermedia controls that allow you to navigate sub-collections, e.g. EPS-SG. Here you can retrieve descriptions of these sub-catalogues as well as hypermedia controls that allow you to query the sub-catalogues"
        },
        {
          "href": "http://.../metopCat/collections/metop",
          "rel": "collection",
          "title": "At this endpoint you can retrieve a description of this catalogue as well as hypermedia controls that allow you to query the metop catalogue."
        }
      ]
   },
   {
      "id": "sentinel3Cat",
      "type": "catalogue",
      "title": "Sentinel3 Catalogue",
      "links": [
        {
          "href": "http://.../sentinelCat/collections",
          "rel": "collections",
          "title": "At this endpoint you can retrieve hypermedia controls that allow you to navigate sub-collections, e.g. Sentinel3. Here you can retrieve descriptions of these sub-catalogues as well as hypermedia controls that allow you to query the sub-catalogues"
         }
      ]
   }
  ]
}
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.opengeospatial.org/pipermail/requests/attachments/20200310/b8884b19/attachment.html>


More information about the Requests mailing list