Skip to content

Add "profile" link attribute to the Link object #1031

@cportele

Description

@cportele

From opengeospatial/ogc-feat-geo-json#129:

We will add "profile" as an additional link attribute as a hint indicating what the profile of the result of dereferencing the link should be. It should only be used in combination with the "type" attribute (since the value identifies the profile of a media type). The "profile" link attribute should be added to the OGC Link schema consistently. In Features Part 1 we will add it in the planned revision 1.1.

This also aligns Features with OGC API Records.

In Features this should be used in at least the following links:

  • self/alternate links
  • items links from the collection

The "profile" link attribute is especially important in cases where different profiles of a format / media type are important to distinguish. The main cases in OGC standards at the moment are the GeoJSON profiles (rfc7946, jsonfg, and jsonfg-plus).

In general multiple profiles may apply (like in the profile query parameter, which is an array).

In a Link header, the profile URIs have to be concatenated, separated by whitespace (like in the link attribute "rel").

In a JSON Link object "profile" is an array, too. See Records.

Example in a collection:

{
  "href": "/collections/foo/items?f=json&profile=rfc7946",
  "type": "application/geo+json",
  "profile": [ "http://www.opengis.net/def/profile/ogc/0/rfc7946" ],
  "rel": "items",
  "title": "The 'foo' features in GeoJSON"
},
{
  "href": "/collections/foo/items?f=json&profile=jsonfg",
  "type": "application/geo+json",
  "profile": [ "http://www.opengis.net/def/profile/ogc/0/jsonfg" ],
  "rel": "items",
  "title": "The 'foo' features in JSON-FG"
}

Metadata

Metadata

Assignees

No one assigned

    Labels

    Part 1: CoreIssue related to Part 1 - Core

    Projects

    Status

    Backlog

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions