Skip to content

Commit 5dd781d

Browse files
tschaubPhil Varner
and
Phil Varner
authored
Use collection relation for links to collection (#404)
* Use collection relation for links to collection * Update ogcapi-features/README.md Co-authored-by: Phil Varner <[email protected]> * Document that the parent and collection relations comes from STAC Item --------- Co-authored-by: Phil Varner <[email protected]>
1 parent 93bf513 commit 5dd781d

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

CHANGELOG.md

+1
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1717
- Added extension field to all OpenAPI specifications `x-conformance-classes` indicating the
1818
conformance classes they define.
1919
- STAC API - Item Search now requires a `root` link relation in the response from `/search`
20+
- Added a `collection` link from and Item to its Collection to conform with the STAC spec.
2021

2122
### Fixed
2223

ogcapi-features/README.md

+3-4
Original file line numberDiff line numberDiff line change
@@ -162,12 +162,11 @@ The following Link relations must exist in the Item object returned from the `/c
162162
| **rel** | **href** | **Media Type** | **From** | **Description** |
163163
| -------- | -------------------------------------------- | -------------------- | ------------------- | --------------------------------------------------- |
164164
| `root` | `/` | application/json | STAC API - Features | The root URI |
165-
| `parent` | `/collections/{collectionId}` | application/json | OAFeat | Parent reference, usually the containing Collection |
165+
| `collection` | `/collections/{collectionId}` | application/json | STAC Item | The containing Collection |
166+
| `parent` | `/collections/{collectionId}` | application/json | STAC Item | Parent reference, usually the containing Collection |
166167
| `self` | `/collections/{collectionId}/items/{itemId}` | application/geo+json | OAFeat | Self reference |
167168

168-
Note that the `parent` link for an Item should point to the containing Collection
169-
(e.g., `/collections/{collectionId}`), rather than the API sub-path
170-
of `/collections/{collectionId}/items/`.
169+
The `parent` link for an Item may point to a Collection or a Catalog. The `collection` link for an Item will always point to the containing Collection. Links to a Collection must point to the `/collections/{collectionId}` endpoint, rather than the API sub-path of `/collections/{collectionId}/items/`.
171170

172171
## Endpoints
173172

0 commit comments

Comments
 (0)