Retrieving multiple versions of a keyword through the KMS API

Use this Forum to find information on, or ask a question about, NASA Earth Science data.
Post Reply
ekeeble_devseed
Posts: 3
Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Answers: 0

Retrieving multiple versions of a keyword through the KMS API

by ekeeble_devseed » Tue Nov 15, 2022 4:08 pm America/New_York

I am wondering if there is a way to view each version of a keyword via the API.

I see that the Concepts route in the API supports a `version` query param (https://wiki.earthdata.nasa.gov/display/ED/KMS+User%27s+Guide#KMSUser'sGuide-2.2ConceptResource). I would expect this to return the properties of the keyword for the provided version, but it seems that setting that query param only modifies the value of `<keywordVersion>` in the response, while the rest of the data stays the same, regardless of which version is specified.

For example, "NASA/JPL/EMIT > Earth Surface Mineral Dust Source Investigation, Jet Propulsion Laboratory, NASA" was updated in version 14.7, but if I request version 14.6 (https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?format=xml&version=14.6), the response body is the same as if I specify 14.7 or don't specify a version.

Am I providing the wrong value to `version` or is this the expected behavior?

Thanks!

Ed

Tags:

GCMD - sritz
User Services
User Services
Posts: 124
Joined: Tue Dec 03, 2019 3:31 pm America/New_York
Answers: 0
Been thanked: 2 times

Re: Retrieving multiple versions of a keyword through the KMS API

by GCMD - sritz » Wed Nov 16, 2022 4:53 pm America/New_York

Hi Ed, I think the issue was with the keyword cache. I cleared the cache and I can now see the difference between the two keywords. The cache helps make the query faster, but sometimes it doesn't clear and you have to do it manually.

https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.6&cache=clear&format=json

https://gcmd.earthdata.nasa.gov/kms/concept/2180640a-ec49-4a1a-a063-460fcdb587a6?version=14.7&cache=clear&format=json

Scott Ritz

ekeeble_devseed
Posts: 3
Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Answers: 0

Re: Retrieving multiple versions of a keyword through the KMS API

by ekeeble_devseed » Wed Nov 16, 2022 5:24 pm America/New_York

Thanks very much, Scott. That looks like it's working.

I was also curious about retrieving a list of the keyword changes published with a given Concept Version. I didn't see an endpoint for that in the docs, but I'm wondering if there's a param I can pass to the Concept Version endpoint or some other way of retrieving it.

Thanks again,
Ed

GCMD - sritz
User Services
User Services
Posts: 124
Joined: Tue Dec 03, 2019 3:31 pm America/New_York
Answers: 0
Been thanked: 2 times

Re: Retrieving multiple versions of a keyword through the KMS API

by GCMD - sritz » Thu Nov 17, 2022 4:36 pm America/New_York

Hi Ed, unfortunately there isn't an endpoint that returns what changed for a given Concept Version. We publish manually created keyword change announcements for each release at https://wiki.earthdata.nasa.gov/display/ED/Keyword+Release+Announcements

Scott

ekeeble_devseed
Posts: 3
Joined: Tue Nov 15, 2022 3:53 pm America/New_York
Answers: 0

Re: Retrieving multiple versions of a keyword through the KMS API

by ekeeble_devseed » Thu Nov 17, 2022 8:34 pm America/New_York

Ok, thanks very much, Scott. I appreciate the quick responses.

Ed

Post Reply