Skip to content

Commit

Permalink
Clarify unique parent link requirement in STAC catalogs
Browse files Browse the repository at this point in the history
  • Loading branch information
emmanuelmathot committed May 7, 2024
1 parent edf2cc9 commit 9c62de3
Showing 1 changed file with 7 additions and 0 deletions.
7 changes: 7 additions & 0 deletions best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -657,6 +657,13 @@ So if you are writing a STAC client it is recommended to start with just support
turn, if your data is published online publicly or for use on an intranet then following these recommendations will ensure
that a wider range of clients will work with it.

#### Unique Parent Link

STAC catalogs do not support multiple parents. Links with `rel` of type `parent` and `collection` must be unique.
Dynamic catalogs can implement multiple parents through a dynamic browsing interface as they could dynamically create the parent
link based on the desired browsing structure (though only 1 parent at a time).
If multiple "parents" are desired the better approach is to use a different relational type (e.g., "related").

### Using Relation Types

Implementors of STAC are highly recommended to be quite liberal with their `links`, and to use the `rel` field (in conjunction
Expand Down

0 comments on commit 9c62de3

Please sign in to comment.