[pygeoapi] Info on Reference for Processing Service

[Tom Kralidis]

Ciao Francesco: references would be encoded as link objects, for example
(for a single referenced input):

{
  "inputs": {
      "href": "
https://raw.githubusercontent.com/radiantearth/stac-spec/refs/heads/master/examples/simple-item.json
",
      "rel": "item"
    }
}

The idea would be to encode resources as links and use the link relation to
help in detection (as well as, say, href HTTP headers and content parsing,
once downloaded).

Admittedly, I've used the below approach, which uses the link object
accordingly, but "qualifies" it (see "source", "target", etc.).

// ingest a STAC item into an OGC API - Records endpoint
{
  "inputs": {
    "source": {
      "href": "
https://raw.githubusercontent.com/radiantearth/stac-spec/refs/heads/master/examples/simple-item.json
",
      "rel": "item"
    },
    "target": {
      "href": "http://localhost:5002",
      "rel": "http://www.opengis.net/spec/ogcapi-records-1/1.0"
    }
  }
}

...which could be encoded also as (per the specification):

{
  "inputs": [{
      "href": "
https://raw.githubusercontent.com/radiantearth/stac-spec/refs/heads/master/examples/simple-item.json
",
      "rel": "item"
    },  {
      "href": "http://localhost:5002",
      "rel": "http://www.opengis.net/spec/ogcapi-records-1/1.0"
  }]
}

....but then my process would have to understand "source" and "target" by
way of array indexing.  I suppose one could define further qualification
with more detailed link relations:

{
  "inputs": [{
      "href": "
https://raw.githubusercontent.com/radiantearth/stac-spec/refs/heads/master/examples/simple-item.json
",
      "rel": "source"
    },  {
      "href": "http://localhost:5002",
      "rel": "target"
  }]
}

...but in my case I'm a bit cautious to go this route, understanding that
defining and documenting a JSON schema of the payload is "easier" than
fully defining and properly documenting link relations.

Hope this helps.

..Tom



On Wed, Feb 26, 2025 at 3:41 AM Francesco Martinelli via pygeoapi <
pygeoapi at lists.osgeo.org> wrote:

> Dear all,
> I am investigating on the possibility to use "reference" instead of
> "value" to pass input information to a Process.
>
> I wonder if anyone already used this opportunity,
> and if there is some available code sample I could access.
>
> Thank you,
> Francesco
>
>
> --
> Dott. Ing. Francesco Martinelli
> Istituto Nazionale di Geofisica e Vulcanologia
> Sezione di Pisa
> Via Cesare Battisti, 53 - 56125 Pisa
> Tel. 050 8311964
> _______________________________________________
> pygeoapi mailing list
> pygeoapi at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/pygeoapi
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/pygeoapi/attachments/20250226/3beabbef/attachment.htm>