From b99e9928822c4bbe2b8afcbed338cc08ab70eb89 Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Thu, 20 Aug 2020 08:29:36 -0700 Subject: [PATCH 1/2] Added via and canonical rel types --- item-spec/item-spec.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/item-spec/item-spec.md b/item-spec/item-spec.md index 7c5fdb375..77ada7e29 100644 --- a/item-spec/item-spec.md +++ b/item-spec/item-spec.md @@ -134,6 +134,8 @@ The following types are commonly used as `rel` types in the Link Object of an It | collection | STRONGLY RECOMMENDED. URL to a [Collection](../collection-spec/README.md). *Absolute* URLs should be used whenever possible. The referenced Collection is STRONGLY RECOMMENDED to implement the same STAC version as the Item. | | derived_from | URL to a STAC Item that was used as input data in the creation of this Item. | | alternate | It is recommended that STAC Items are also available as HTML, and should use this rel with `"type" : "text/html"` to tell clients where they can get a version of the Item to view in a browser. See [STAC on the Web in Best Practices](../best-practices.md#stac-on-the-web) for more information. | +| canonical | The URL of the [canonical](https://en.wikipedia.org/wiki/Canonical_link_element) version of the Item. API responses and copies of catalogs should use this to inform users that they are direct copy of another STAC Item, using the canonical rel to refer back to the primary location. | +| via | The URL of the metadata that this STAC Item is created from. Used similarly to canonical, but refers back to a non-STAC record (Landsat MTL, Sentinel tileInfo.json, etc) | A more complete list of possible 'rel' types can be seen at the [IANA page of Link Relation Types](https://www.iana.org/assignments/link-relations/link-relations.xhtml). From 560c352e0af1b87975bfe12f679786f7acc6d67d Mon Sep 17 00:00:00 2001 From: Chris Holmes Date: Thu, 20 Aug 2020 08:31:29 -0700 Subject: [PATCH 2/2] Update CHANGELOG.md --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 23a1fac5e..30bc74299 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. ## [Unreleased] ### Added + - 'via' and 'canonical' rel types as options in items. ### Changed