Collection ID requirement in STAC search API #385
777arc
announced in
Announcements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
This announcement is related to the Planetary Computer API, which allows users to search for the data they need across space and time. Starting early next week (end of Oct 2024), we are making a temporary change that will now require any STAC searches (a GET or POST to the /search endpoint) to specify a collection ID, either in the body of a POST, the query params of a GET, or within a filter (e.g., "args": [{"property": "collection"}, your_collection_id]) [1]. If using the Python API, the collection ID is specified as shown in [2]. Even though the STAC API spec does not require a collection ID to be specified, the Planetary Computer contains hundreds of collections across PBs of data. Searches that don't specify a collection ID are expensive and can result in performance issues. We apologize for the short notice but given the possible impact to the health of the service, this change needs to be applied sooner. The staging instance has the change deployed and can be used for testing [3]. In the near future, we plan to add back the ability to do a search without collection ID specified to be compliant with STAC API specification.
[1] microsoft/planetary-computer-apis#240
[2] https://planetarycomputer.microsoft.com/docs/quickstarts/reading-stac#Searching
[3] https://planetarycomputer-staging.microsoft.com/api/stac/v1
-Marc
Beta Was this translation helpful? Give feedback.
All reactions