You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|`root`|`/`| application/json | STAC API - Core |**REQUIRED** The root URI |
75
+
|`self`|`/`| application/json | OAFeat |**REQUIRED** Self reference, same as root URI |
76
+
|`service-desc`|`/api`| various | OAFeat |**REQUIRED** The service description in a machine-readable format |
77
+
|`service-doc`|`/api.html`| text/html | OAFeat | A human-consumable service description. The path for this endpoint is only recommended to be `/api.html`, but may be another path. |
78
+
|`child`| various | application/json | STAC API - Core | The child STAC Catalogs & Collections. |
79
+
|`item`| various | application/geo+json | STAC API - Core | The child STAC Items. |
77
80
78
81
The path for the `service-desc` endpoint is recommended to be `/api`, but may be another path. Recommended to be
79
82
OpenAPI 3.0 or 3.1 with media types `application/vnd.oai.openapi` (YAML),
@@ -85,18 +88,9 @@ page, for example, in the form of [Redoc](https://github.com/Redocly/redoc) inte
85
88
, but any format is allowed. The Link `type` field should correspond to whatever format or formats are
|`service-doc`|`/api.html`| text/html | OAFeat | A human-consumable service description. The path for this endpoint is only recommended to be `/api.html`, but may be another path. |
91
-
92
91
Additionally, `child` relations may exist to child Catalogs and Collections and `item` relations to Items. These
93
92
relations form a directed graph that enables traversal from a root catalog or collection to items.
|`search`|`/search`| application/geo+json | STAC API - Item Search |**REQUIRED**URI for the Search endpoint |
63
63
64
64
This `search` link relation must have a `type` of `application/geo+json`. If no `method` attribute is
65
65
specified, it is assumed to represent a GET request. If the server supports both GET and POST requests, two links should be included, one with a `method` of `GET` one with a `method` of `POST`.
66
66
67
67
Other links with relation `search` may be included that advertise other content types the server may respond
68
68
with, but these other types are not part of the STAC API requirements.
69
69
70
-
The following Link relations must exist in the `/search` endpoint response.
70
+
The following Link relations are defined for the `/search` endpoint response.
|`canonical`| various | various | STAC API - Core | Provides the preferred paths to get to STAC Collection and Item objects, if they differ from the URL that was used to retrieve the STAC object and thus duplicate other content. This can be useful in federated catalogs that present metadata that has a different location than the source metadata. |
|`parent`|`/`| application/json | STAC Collection | Parent reference, usually the root Catalog |
134
+
|`canonical`| various | various | STAC API - Core | Provides the preferred paths to get to STAC Collection and Item objects, if they differ from the URL that was used to retrieve the STAC object and thus duplicate other content. This can be useful in federated catalogs that present metadata that has a different location than the source metadata. |
140
135
141
136
Usually, the `self` link in a Collection must link to the same URL that was used to request
142
137
it. However, implementations may choose to have the canonical location of the Collection be
@@ -147,26 +142,29 @@ of that Collection, rather than the API sub-path of `/collections`.
|`collection`|`/collections/{collectionId}`| application/json | STAC Item |**REQUIRED** The containing Collection|
162
+
|`parent`|`/collections/{collectionId}`| application/json | STAC Item| Parent reference, usually the containing Collection|
168
163
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/`.
164
+
The `parent` link for an Item may point to a Collection or a Catalog. The
165
+
`collection` link for an Item will always point to the containing Collection.
166
+
Links to a Collection must point to the `/collections/{collectionId}` endpoint,
167
+
rather than the API sub-path of `/collections/{collectionId}/items/`.
0 commit comments