search

radiantearth / stac-spec

SpatioTemporal Asset Catalog specification - making geospatial assets openly searchable and crawlable
https://stacspec.org
Apache License 2.0
777 stars 178 forks source link

"item" v. "items" in collections #1312

Closed tpoisot closed 1 month ago

tpoisot commented 1 month ago

In JuliaClimate/STAC.jl#17 we found a tricky situation where the STAC spec says "rel" can be "item" for links, but some catalogues (ESA, Planetary computer, and GEOBON) use "items" for their links.

The STAC API spec says the relationship from collection to item should use "item".

Where is the use of "items" documented, and is it something that's to be expected or a "convention" that some catalogues started using?

(cc. @glaroc / @jmlord)

m-mohr commented 1 month ago

items is a relation type in the STAC API spec that leads to a list of items, the item relation type is from STAC spec and leads to a single item. It's documented here: https://github.com/radiantearth/stac-api-spec/tree/release/v1.0.0/ogcapi-features I hope that clarifies it.