Skip to content

Use collection relation for links to collection #404

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 13, 2023
Merged

Use collection relation for links to collection #404

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
57f16d0
Use collection relation for links to collection
tschaub Mar 7, 2023
4e38467
Update ogcapi-features/README.md
tschaub Mar 13, 2023
196816a
Document that the parent and collection relations comes from STAC Item
tschaub Mar 13, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Added extension field to all OpenAPI specifications `x-conformance-classes` indicating the
conformance classes they define.
- STAC API - Item Search now requires a `root` link relation in the response from `/search`
- Added a `collection` link from and Item to its Collection to conform with the STAC spec.

### Fixed

Expand Down
7 changes: 3 additions & 4 deletions ogcapi-features/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -157,12 +157,11 @@ The following Link relations must exist in the Item object returned from the `/c
| **rel** | **href** | **Media Type** | **From** | **Description** |
| -------- | -------------------------------------------- | -------------------- | ------------------- | --------------------------------------------------- |
| `root` | `/` | application/json | STAC API - Features | The root URI |
| `parent` | `/collections/{collectionId}` | application/json | OAFeat | Parent reference, usually the containing Collection |
| `collection` | `/collections/{collectionId}` | application/json | STAC Item | The containing Collection |
| `parent` | `/collections/{collectionId}` | application/json | STAC Item | Parent reference, usually the containing Collection |
| `self` | `/collections/{collectionId}/items/{itemId}` | application/geo+json | OAFeat | Self reference |

Note that the `parent` link for an Item should point to the containing Collection
(e.g., `/collections/{collectionId}`), rather than the API sub-path
of `/collections/{collectionId}/items/`.
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/`.

## Endpoints

Expand Down