Skip to content
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.

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

What to do when a collection can be accessed as an EDR resource and as features or coverages? #68

Closed
dblodgett-usgs opened this issue May 28, 2020 · 2 comments

Comments

@dblodgett-usgs
Copy link
Contributor

dblodgett-usgs commented May 28, 2020

(edit to update my understanding of the issue)

Currently, API-Features specifies that a collection has itemType Feature which is a typing mechanism for the items from the feature. There is no typing mechanism(s) for collections themselves.

What do we want to do in the case that a collection is both accessible as a feature collection or via an EDR query pattern?

It's easy to imagine a world where we would want to support Features, Coverages, and some EDR query patterns. Once we get out to the /collections/{collectionid}/items or /collections/{cooverageid}/coverages or /collections/{collectionid}/area resource, things are fine, but the cataloging of coverages that have multiple overlapping types needs to be solved.

I'm asking this as a leading question related to #38 and opengeospatial/ogcapi-common#140 to provide some food for thought and to reiterate the distinction between the two options I offer in opengeospatial/ogcapi-common#140:

  1. Will the collections end point be a container (catalog) for flexibly typed resources that are ostensibly datasets?
  2. Will the collections end point be reserved for collections of things that are ostensibly features?

Records is saying that the itemType of a collection that conforms to the records API is catalog. Which works because a catalog is also conformant to and is an extension of Features.

This itemType only tells us the type of items available from a collection. For other endpoints under /collections/{collectionid}, such as .../area or .../coverage we would need an additional typing mechanism. Let's call it accessType for the sake of this issue.

So for EDR, we could have a itemType of edrFeature (or some such) that would be our extension of Features and have accessType of items, area, position, etc.

@dblodgett-usgs
Copy link
Contributor Author

  1. as discussed in: Collections Discussion ogcapi-common#140 we will use link relations to describe the availability of alternate distributions of a collection -- not an accessType element in a json-schema for collection info.
  2. How itemType will be used is still an open question but does not need to block EDR from moving forward. Presumably we would need an itemType for our schema for the items feature collection.

@dblodgett-usgs
Copy link
Contributor Author

This issue was discussed in https://github.com/opengeospatial/Environmental-Data-Retrieval-API/wiki/2020-06-04 -- we agreed that opengeospatial/ogcapi-common#140 and the summary I gave just above is good and we can move forward.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant