Page tree
Skip to end of metadata
Go to start of metadata

1 Introduction

The Keyword Management Service (KMS) is a RESTful web service for maintaining keywords (science keywords, platforms, instruments, data centers, locations, projects, services, resolution, etc.) in the GCMD/IDN system. It allows access to the keywords maintained in the Keyword Management System as SKOS Concepts (RDF, JSON, OWL) or as XML <Concept /> objects. Simple Knowledge Organization System (SKOS) is a standard defined for representation of thesauri, classification schemes, taxonomies, subject-heading systems, or any other type of controlled vocabulary. SKOS is built upon RDF and RDFS, and its main objective is to enable easy publication of controlled structured vocabularies for the Semantic Web. SKOS is currently developed within the W3C framework. Section 1.1 contains a list of attributes associated with a SKOS Concept.

1.1 SKOS Concept

    • concept scheme (e.g., science keywords, platforms, instruments, etc.)
    • concept id (globally unique, read only)
    • broader - list of broader concepts
    • narrower - list of narrower concepts
    • related - list of related concepts
    • definition- one per language
    • pref label - preferred, one per language
    • pref symbol - image of the concept, second phase but interface should support it's addition
    • alt labels - list, multiple per language
    • alt symbol - image, second phase but interface should support it's addition
    • hidden labels - list (common misspellings), second phase?
    • change note - list of changes, human and computer inserted sorted by time
      • date - computer managed
      • note

2 REST paths

Accessing the SKOS concepts is made possible through the following list of REST-based paths; 2.1 Connections,2.2 Concept Resource, 2.3 Concepts – Root, 2.4 Concepts - By Pattern, 2.5 Concepts - By Concept Scheme + Pattern, 2.6 Concepts By Alternate Label Resource, 2.7 Concepts By Full Path Resource, 2.8 Concepts Name Resource, 2.9 Concepts Relation Resource, 2.10 Concept Schemes Resource, 2.11 Concept Versions Resource, 2.12 Concepts in Concept Scheme Resource. See additional detailed information below.

2.1 Connections

The /KMS/ server infrastructure monitors inbound traffic and attempts to prevent over usage such as a Denial of Service (DoS) attack. To do this, the server will only allow so many connections per time interval and total connections at any given time. The current values are:

  • 64 connections at one time
  • 50 started connections within 5 seconds.

If processing records synchronously, then put a 100ms delay between each call. Alternatively mark the start time at the beginning of a block of records, then after processing 50 records check the elapsed execution time. If the elapsed execution time is less then 5 seconds, add a sleep for the difference. The generic logic of this work flow is below:

  1. Start
  2. Save timestamp1 (in ms), reset counter1
  3. Loop
    1. process record
    2. ++counter1
    3. if counter1 >= 50
      1. save timestamp2 (in ms)
      2. if timestamp2-timestamp1 < 5,000ms then sleep for 5,000ms-(timestamp2-timestamp1)
  4. End

2.2 Concept Resource

Complete details of the concept with the given conceptId

URL

/concepts/{conceptId}

Method

GET

HTTP Accepts

  • application/rdf+xml
  • application/xml

Path Params

  • conceptId

Query Params

  • version
  • case
  • format:
    • "xml"
    • "rdf (default)

Form Params

  • none

HTTP Headers

  • Content-MD5
  • Last-Modified

Returns

  • media types: "application/xml",
  • "application/rdf+xml"
  • “application/json”
  • Error code: 404 Not Found (identifier not found)

Examples

Request for a response in RDF format: https://gcmdservices.gsfc.nasa.gov/kms/concept/085edf65-1c8c-414a-b8e4-a1a08ff08f22?format=rdf 

 
<rdf:RDF><gcmd:gcmd><gcmd:termsOfUse>http://gcmd.nasa.gov/r/l/TermsOfUse</gcmd:termsOfUse><gcmd:keywordVersion>8.5</gcmd:keywordVersion><gcmd:schemeVersion>2017-09-22 12:50:06</gcmd:schemeVersion></gcmd:gcmd><skos:Concept rdf:about="085edf65-1c8c-414a-b8e4-a1a08ff08f22" xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/"><skos:inScheme rdf:resource="https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords"/><skos:prefLabel xml:lang="en">POPULATION</skos:prefLabel><skos:definition xml:lang="en">Refers to the total number of inhabitants constituting a particular race, class, or group in a specified area.</skos:definition><skos:broader rdf:resource="fb93d937-c17c-45d0-a9e3-ca5c8a800ca8"/><skos:narrower rdf:resource="ae9f3a07-f23e-4116-b172-677435102b2f"/><skos:narrower rdf:resource="dd0b8bc9-90b3-4e7d-a021-e91dc676d622"/><skos:narrower rdf:resource="d2a5c7ec-ccf2-4ab7-8863-9063be91c022"/><skos:narrower rdf:resource="d7ad5cff-75df-4bb6-92f0-b5d56da2a588"/><skos:narrower rdf:resource="9d6eda76-cf5d-4170-92ce-9ac9197832bf"/><skos:narrower rdf:resource="3fd888c4-2fd2-4ce1-8753-3158e2826ef7"/><skos:changeNote>2012-07-11 11:21:42.0 [tbs1979]  
update Definition (Refers to the total number of inhabitants constituting a particular race, class, or group in a specified area.);
update Definition (Dictionary.com);
</skos:changeNote><skos:changeNote>2012-06-28 09:57:09.0 [tbs1979] Insert Concept
add narrower relation (POPULATION [085edf65-1c8c-414a-b8e4-a1a08ff08f22,21255] - MORTALITY [3fd888c4-2fd2-4ce1-8753-3158e2826ef7,40263]);
</skos:changeNote><skos:changeNote>2012-06-28 09:56:24.0 [tbs1979] Insert Concept
add narrower relation (POPULATION [085edf65-1c8c-414a-b8e4-a1a08ff08f22,21255] - NATALITY [9d6eda76-cf5d-4170-92ce-9ac9197832bf,40259]);
</skos:changeNote><skos:changeNote>2012-06-28 09:55:48.0 [tbs1979] Insert Concept
add narrower relation (POPULATION [085edf65-1c8c-414a-b8e4-a1a08ff08f22,21255] - POPULATION ESTIMATES [d7ad5cff-75df-4bb6-92f0-b5d56da2a588,40257]);
</skos:changeNote><skos:changeNote>2012-06-28 09:54:58.0 [tbs1979] Insert Concept
add narrower relation (POPULATION [085edf65-1c8c-414a-b8e4-a1a08ff08f22,21255] - POPULATION DENSITY [d2a5c7ec-ccf2-4ab7-8863-9063be91c022,40255]);
</skos:changeNote></skos:Concept></rdf:RDF>


2.3 Concepts - Root

Returns list of all root concepts (that are at the top of the hierarchy) as conceptBriefs

URL

/concepts/root

Method

GET

HTTP Accepts

  • application/rdf+xml
  • application/xml

Path Params

  • none

Query Params

  • version
  • case
  • format
    • "xml"
    • "rdf (default)

Form Params

  • none

HTTP Headers

  • Content-MD5
  • X-GCMD-Count
  • X-GCMD-Content-SHA

Returns

  • media types:
    • "application/xml"
    • "application/rdf+xml"

Examples

Request for the list of root concepts: https://gcmdservices.gsfc.nasa.gov/kms/concepts/root?format=rdf

 
<?xml version="1.0" encoding="UTF-8"?>
 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
        xmlns:skos="http://www.w3.org/2004/02/skos/core#">
    <gcmd:termsOfUse xmlns:gcmd="http://gcmd.gsfc.nasa.gov/">
        See https://gcmd.nasa.gov/r/l/TermsOfUse
    </gcmd:termsOfUse>
    <skos:Concept rdf:about="5a7a033c-c1f0-40c2-949c-4b4be4410ce6"
            xml:base="http://sandbox-qa1.gsfc.nasa.gov/kms/concept/"
            xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#">
        <skos:inScheme rdf:resource=
            "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/chronounits"/>
        <skos:prefLabel xml:lang="en">Chronostratigraphic Units</skos:prefLabel>
        <skos:narrower rdf:resource="a0f8c033-b9e2-49e8-bc61-c39c962edff2"/>
        <skos:narrower rdf:resource="af145656-986a-4969-bb77-6e5b2cff1ede"/>
        <skos:narrower rdf:resource="c7626c29-a1d3-4d0c-a263-616fe060f164"/>
        <skos:narrower rdf:resource="4407ca3c-3dc0-402c-bfc3-4dabd23f283a"/>
    </skos:Concept>
    …
 </rdf:RDF>


2.4 Concepts - By Pattern

Returns a list of all concepts that match a given pattern across all concept schemes

URL

/concepts/pattern/{pattern}

Method

GET

HTTP Accepts

  • application/xml

Path Params

  • pattern
  • conceptScheme

Query Params

  • version
  • case
  • format
    • "xml"
    • "rdf" (default)

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • media types
  • "application/xml"
  • "application/rdf+xml"

Examples

Request for a list of concepts that match a given pattern: https://gcmdservices.gsfc.nasa.gov/kms/concepts/pattern/OCEANS?format=rdf

 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
        xmlns:skos="http://www.w3.org/2004/02/skos/core#">
    <gcmd:termsOfUse xmlns:gcmd="http://gcmd.gsfc.nasa.gov/">
        See https://gcmd.nasa.gov/r/l/TermsOfUse
    </gcmd:termsOfUse>
    <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#"
            rdf:about="91697b7d-8f2b-4954-850e-61d5f61c867d"
            xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
        <skos:inScheme rdf:resource=
            "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords" />
        <skos:prefLabel xml:lang="en">OCEANS</skos:prefLabel>
        <skos:broader rdf:resource="10206308-a9dd-41e8-ba40-056c1160842a" />
        <skos:narrower rdf:resource="251c87cd-03b3-464f-8390-8ede2fec28fc" />
        <skos:narrower rdf:resource="a031952d-9f00-4ba5-9966-5f87ab9dfdd4" />
        <skos:narrower rdf:resource="346cade5-801a-4afc-9652-48d02905bc4f" />
        <skos:narrower rdf:resource="e3b178eb-2d47-41db-aba1-43a05e9e9256" />
        <skos:narrower rdf:resource="e3bef663-6116-4f15-995c-38c7cdc9652c" />
        <skos:narrower rdf:resource="a04804d5-1064-48fd-a7a7-8da8e10399e1" />
        <skos:narrower rdf:resource="1ee8a323-f0ba-4a21-b597-50890c527c8e" />
        <skos:narrower rdf:resource="ca154e02-a226-4cc7-8e4a-4474e7eb1eeb" />
        <skos:narrower rdf:resource="6eb3919b-85ce-4988-8b78-9d0018fd8089" />
        <skos:narrower rdf:resource="457883c4-b30c-4d26-bed8-6c2887ebbc90" />
        <skos:narrower rdf:resource="c16bda61-353b-4668-af2f-bbb98785b6fa" />
        <skos:narrower rdf:resource="bfa56100-6fb5-4e49-9633-298fa3b45508" />
        <skos:narrower rdf:resource="f27ad52c-3dfd-4788-851a-427e60ae1b8f" />
        <skos:narrower rdf:resource="0517ae1f-7617-4f3b-80cb-649178032825" />
        <skos:narrower rdf:resource="a46016d7-e571-403a-ab37-7223fd74e68e" />
        <skos:narrower rdf:resource="d73e969a-4b66-4713-8d63-fa3cbb1e25e3" />
        <skos:narrower rdf:resource="bb04ee83-bf49-4f96-898d-20bb6e92bc93" />
        <skos:narrower rdf:resource="ce4b2c6e-3d69-4cf1-8416-c36e5f9b1b2c" />
        <skos:narrower rdf:resource="b6fd22ab-dca7-4dfa-8812-913453b5695b" />
        <skos:narrower rdf:resource="63bc0693-52eb-4ebd-a39e-e77e96409072" />
        <skos:narrower rdf:resource="68f93a0c-1525-4f5a-9545-5d94191a3dbf" />
    </skos:Concept>
    <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#"
            rdf:about="75aed409-af9f-430b-ba97-4b92cbfcf3a5"
            xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
        <skos:inScheme rdf:resource=
            "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/providers" />
        <skos:prefLabel xml:lang="en">AU/OCEANS</skos:prefLabel>
        <skos:altLabel xml:lang="en">
            National Oceans Office, Department of the Environment and Heritage,
            Australian Government
        </skos:altLabel>
       <skos:broader rdf:resource="03e2acdd-67f7-4380-8c82-53aeb1d4730e" />
    </skos:Concept>
    <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#"
            rdf:about="dbff9ea9-3b00-4cd4-b3ed-21790a797207"
            xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
        <skos:inScheme rdf:resource=
           "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/isotopiccategory" />
        <skos:prefLabel xml:lang="en">OCEANS</skos:prefLabel>
        <skos:broader rdf:resource="4c715ec3-7f1b-432b-b393-f9a971a77664" />
    </skos:Concept>
 </rdf:RDF>


2.5 Concepts - By Concept Scheme + Pattern

Returns list of all concepts within specified concept scheme that match a given pattern

URL

/concepts/concept_scheme/{conceptScheme}/pattern/{pattern}

Method

GET

HTTP Accepts

  • Accept:application/rdf+xml
  • Accept:application/xml

Path Params

  • conceptScheme: chronounits,

discipline, horizontalresolutionrange, idnnode, instruments, isotopiccategory, locations, platforms, projects, providers, rucontenttype, sciencekeywords, temporalresolutionrange, verticalresolutionrange

  • pattern

Query Params

  • version
  • case
  • format
    • "xml" - same as "Accept:application/xml
    • "rdf" (default) - Accept:application/rdf+xml
    • "text/csv" - report

Form Params

  • none

HTTP Headers

  • Content-MD5
  • Last-Modified


Returns

  • media types
    • "application/xml"
    • "application/rdf+xml"
    • “ application/json”

Examples

Request for a list of concepts that match a given pattern within a given concept scheme: https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/discipline/pattern/water?format=rdf


 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
 <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
        xmlns:skos="http://www.w3.org/2004/02/skos/core#">
    <gcmd:termsOfUse xmlns:gcmd="http://gcmd.gsfc.nasa.gov/">
        See https://gcmd.nasa.gov/r/l/TermsOfUse
    </gcmd:termsOfUse>
    <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#"
            rdf:about="7209c13f-eee0-4dd0-ada8-732900b58e61"
            xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
        <skos:inScheme rdf:resource=
            "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/discipline"/>
        <skos:prefLabel xml:lang="en">FRESHWATER ECOLOGY</skos:prefLabel>
        <skos:broader rdf:resource="d4d928d7-099b-4d4a-8f97-c92a09cdf8a7"/>
    </skos:Concept>
    <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
            xmlns:skos="http://www.w3.org/2004/02/skos/core#"
            rdf:about="386b6504-2d13-442d-8ffa-9fab8d82f3a4"
            xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
        <skos:inScheme rdf:resource=
            "https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/discipline"/>
        <skos:prefLabel xml:lang="en">FRESHWATER</skos:prefLabel>
        <skos:broader rdf:resource="e0b60b65-5850-4165-ba4b-e68adefd249b"/>
    </skos:Concept>
 </rdf:RDF>


Request a CSV format:

https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/discipline/pattern/water?format=csv

 
 Terms Of Use: See https://gcmd.nasa.gov/r/l/TermsOfUse
 Keyword Version: Jun122017
 Discipline_Name,Subdiscipline
 "EARTH SCIENCE","FRESHWATER"
 "ECOLOGY","FRESHWATER ECOLOGY 


2.6 Concepts By Alternate Label Resource

Returns a concept with an alternate label

URL

/concept/alt_label/{alt_label}

Method

GET

HTTP Accepts

  • application/json

Path Params

  • alt_label

Query Params


  • version
  • scheme
  • format

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • "application/json"

Examples

Request for a concept with an alt label: https://gcmdservices.gsfc.nasa.gov/kms/concept/alt_label/Aura?scheme=platforms


{
    "termsOfUse": "See http://gcmd.nasa.gov/r/l/TermsOfUse",
    "keywordVersion": "8.5",
    "schemeVersion": "2017-09-14 14:48:28",
    "lastModifiedDate": "2016-10-13 16:39:46.0",
    "id": 287847,
    "uuid": "59d2e030-5377-4b5b-92ce-f488d418c45f",
    "prefLabel": "AURA",
    "altLabels": [
        {"text": "Aura"},
        {"category": "primary","text": "Earth Observing System, Aura"}
    ],
    "resources": [
        {"type": "IMAGE","url": "http://gcmd.gsfc.nasa.gov/KeywordSearch/default/images/aura.gif"}
    ],
    "isLeaf": "true",
    "broader": [
        {
            "id": 287601,
            "uuid": "3466eed1-2fbb-49bf-ab0b-dc08731d502b",
            "prefLabel": "Earth Observation Satellites",
            "conceptScheme": "platforms",
            "isLeaf": "false"
        }


2.7 Concepts By Full Path Resource

Returns a concept by the full path

URL

/concept/full_path/

Method

GET

HTTP Accepts

  • application/json

Path Params

  • full_path

Query Params


  • version
  • format
  • case

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • "application/jsonl"

Examples

Request for a concept (Soil pH) by the full path: https://gcmdservices.gsfc.nasa.gov/kms/concept/full_path/EARTH+SCIENCE|AGRICULTURE|SOILS|SOIL+PH


<concept xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="306347" uuid="2a9bce94-c391-4834-96bb-a9685d3590b1" lang="en" checksum=" " isRoot="false" status=" "xsi:noNamespaceSchemaLocation="http://gcmd.gsfc.nasa.gov/Aboutus/xml/kms/kms.xsd">
 <termsOfUse>http://gcmd.nasa.gov/r/l/TermsOfUse</termsOfUse>  
<keywordVersion>8.5</keywordVersion>  
 <schemeVersion>2017-09-22 12:50:06</schemeVersion>  
 <prefLabel id="306315" status="NO_CHANGE">SOIL PH</prefLabel>  
 <altLabels/>  
 <definition status="NO_CHANGE" reference=" " id="242425">The negative log of Hydrogen ion concentration</definition>   
<altSymbols/>   
<broader> 
 <conceptBrief id="303699" uuid="199e3af8-4cf3-48ba-8b28-b9b54756b3db" prefLabel="SOILS" conceptSchemeId="663" conceptScheme="sciencekeywords" isLeaf="false" status=" "/>  
 </broader>
 <narrower/>  <related/>  <conceptScheme id="663" name="sciencekeywords" longName="Science Keywords"/>  
 <resources/>   
<changeNotes/>  
 </concept>

2.8 Concepts Name Resource

Returns a concept by the concept short name

URL

/concept/short_name

Method

GET

HTTP Accepts

  • application/json

Path Params

  • short_name

Query Params


  • version
  • scheme
  • format
  • case

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • "application/json"

 

Examples

Request for a concept by short name: https://gcmdservices.gsfc.nasa.gov/kms/concept/short_name/ESIP?scheme=projects


{
    "termsOfUse": "See http://gcmd.nasa.gov/r/l/TermsOfUse",
    "keywordVersion": "8.5",
    "schemeVersion": "2017-09-20 10:44:51",
    "id": 293099,
    "uuid": "5f139d40-4050-4a8e-bd2b-fcae1cfe3d01",
    "prefLabel": "ESIP",
    "altLabels": [
        {"category": "primary","text": "Earth Science Information Partners Program"}
    ],
    "isLeaf": "true",
    "broader": [
        {
            "id": 292305,
            "uuid": "24cf4b0e-4464-4edb-8f0c-415e851a6d79",
            "prefLabel": "D - F",
            "conceptScheme": "projects",
            "isLeaf": "false"
        }
    ],
    "conceptScheme":{"name": "projects","longName": "Projects"}
}


2.9 Concepts Relation Resource

Returns a list of concepts with their relationships

URL

/concept_relation/

Method

GET

HTTP Accepts

  • application/json

Path Params

  • none

Query Params


  • scheme
  • relation_type
  • case

Form Params

  • none

HTTP Headers

  • none

Returns

  • "application/json"

 

Examples

Request for a list of instruments and their relationship to a a platform (MODIS flies on AQUA and TERRA): https://gcmdservices.gsfc.nasa.gov/kms/concept_relation/?scheme=instruments&relation_type=is_on_platform


    {
      "prefLabel": "MODIS",
      "scheme": "instruments",
      "uuid": "2878f334-35dc-47a7-a3ae-8c5da1adccd3",
      "relatedConcepts": [
        {
          "prefLabel": "AQUA",
          "relationType": "is_on_platform",
          "uuid": "ea7fd15d-190d-43f3-bdd3-75f5d88dc3f8",
          "scheme": "platforms"
        },
        {
          "prefLabel": "TERRA",
          "relationType": "is_on_platform",
          "uuid": "80eca755-c564-4616-b910-a4c4387b7c54",
          "scheme": "platforms"
        }


Request for a list of platforms and their relatiopship to an instrument (AQUA has a MODIS instrument): https://gcmdservices.gsfc.nasa.gov/kms/concept_relation/?scheme=platforms&relation_type=has_instrument

{
      "prefLabel": "AQUA",
      "scheme": "platforms",
      "uuid": "ea7fd15d-190d-43f3-bdd3-75f5d88dc3f8",
      "relatedConcepts": [
        {
          "prefLabel": "AMSR-E",
          "relationType": "has_instrument",
          "uuid": "736038ef-c1ae-47c7-a50e-729474eeb3b1",
          "scheme": "instruments"
        },
        {
          "prefLabel": "AMSU-A",
          "relationType": "has_instrument",
          "uuid": "2a393a42-ecf9-4137-b1ea-1c25692384b4",
          "scheme": "instruments"
        },
        {
          "prefLabel": "CERES-FM3",
          "relationType": "has_instrument",
          "uuid": "b4d51bd0-047f-4365-98cf-acfe4370eec0",
          "scheme": "instruments"
        },
        {
          "prefLabel": "CERES-FM4",
          "relationType": "has_instrument",
          "uuid": "b1a560d0-e9cb-4ce3-9c06-c354bcf1833f",
          "scheme": "instruments"
        },
        {
          "prefLabel": "HSB",
          "relationType": "has_instrument",
          "uuid": "e257079e-3775-4f95-b42d-b2e4ffab00e8",
          "scheme": "instruments"
        },
        {
          "prefLabel": "MODIS",
          "relationType": "has_instrument",
          "uuid": "2878f334-35dc-47a7-a3ae-8c5da1adccd3",
          "scheme": "instruments"
        },
        {
          "prefLabel": "AIRS",
          "relationType": "has_instrument",
          "uuid": "a9bd961e-1063-4f37-99b6-ecd77aa9eb40",
          "scheme": "instruments"


2.10 Concept Schemes Resource

Returns a list of all the concept schemes

URL

/concept_schemes/

Method

GET

HTTP Accepts

  • application/xml

Path Params

  • none

Query Params


  • version

Form Params

  • none

HTTP Headers

  • none

Returns

  • "application/xml"

Examples

Request for a list of all the concept schemes: https://gcmdservices.gsfc.nasa.gov/kms/concept_schemes/


<schemes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://gcmd.gsfc.nasa.gov/Aboutus/xml/kms/kms.xsd">
<scheme id="639" name="CollectionDataType" longName="Collection Data Type" updateDate="2016-09-21"/>
<scheme id="653" name="ContactType" longName="Contact Type" updateDate="2016-09-22"/>
<scheme id="641" name="CoordinateSystem" longName="Coordinate System" updateDate="2016-09-21"/>
<scheme id="655" name="Country" longName="Country" updateDate="2016-06-21"/>
<scheme id="625" name="DatasetLanguage" longName="Dataset Language" updateDate="2016-09-21"/>
<scheme id="623" name="DatasetProgress" longName="Dataset Progress" updateDate="2016-09-21"/>
<scheme id="659" name="DistributionSizeUnit" longName="Distribution Size Unit" updateDate="2016-09-22"/>
<scheme id="635" name="DurationUnit" longName="Duration Unit" updateDate="2016-09-21"/>
<scheme id="643" name="GranuleSpatialRepresentation" longName="Granule Spatial Representation" updateDate="2016-09-21"/>
<scheme id="627" name="MetadataAssociationType" longName="Metadata Association Type" updateDate="2016-09-21"/>
<scheme id="651" name="MetadataLanguage" longName="Metadata Language" updateDate="2016-06-21"/>
<scheme id="613" name="MetadataVersion" longName="Metadata Version" updateDate="2016-06-10"/>
 
<scheme id="657" name="MimeType" longName="Mime Type" updateDate="2017-07-17"/>
<scheme id="649" name="MultimediaFormat" longName="Multimedia Format" updateDate="2016-09-23"/>
<scheme id="629" name="OrganizationPersonnelRole" longName="Organization Personnel Role" updateDate="2016-09-21"/>
<scheme id="633" name="OrganizationType" longName="Organization Type" updateDate="2016-09-21"/>
<scheme id="615" name="PersistentIdentifier" longName="Persistent Identifier" updateDate="2016-06-10"/>
<scheme id="631" name="PersonnelRole" longName="Personnel Role" updateDate="2016-09-21"/>
<scheme id="619" name="PhoneType" longName="Phone Type" updateDate="2016-09-21"/>
<scheme id="637" name="PlatformType" longName="Platform Type" updateDate="2016-09-21"/>
<scheme id="617" name="Private" longName="Private" updateDate="2016-06-10"/>
<scheme id="621" name="ProductFlag" longName="Product Flag" updateDate="2016-09-21"/>
<scheme id="645" name="ProductLevelId" longName="Product Level Id" updateDate="2016-10-26"/>
<scheme id="647" name="SpatialCoverageType" longName="Spatial Coverage Type" updateDate="2016-09-21"/>
<scheme id="585" name="chronounits" longName="Chronostratigraphic Units" updateDate="2015-09-02"/>
<scheme id="597" name="discipline" longName="Disciplines" updateDate="2012-10-19"/>
<scheme id="605" name="horizontalresolutionrange" longName="Horizontal Resolution Ranges" updateDate="2013-03-19"/>
<scheme id="599" name="idnnode" longName="IDN Nodes" updateDate="2016-04-06"/>
<scheme id="593" name="instruments" longName="Instruments" updateDate="2017-09-14"/>
<scheme id="601" name="isotopiccategory" longName="ISO Topic Categories" updateDate="2016-10-28"/>
<scheme id="587" name="locations" longName="Locations" updateDate="2017-07-25"/>
<scheme id="591" name="platforms" longName="Platforms" updateDate="2017-09-14"/>
<scheme id="595" name="projects" longName="Projects" updateDate="2017-09-20"/>
<scheme id="589" name="providers" longName="Providers" updateDate="2017-08-18"/> 
<scheme id="603" name="rucontenttype" longName="Related URL Content Types" updateDate="2017-09-20"/>
<scheme id="663" name="sciencekeywords" longName="Science Keywords" updateDate="2017-09-22"/> 
<scheme id="609" name="temporalresolutionrange" longName="Temporal Resolution Ranges" updateDate="2017-06-01"/>
<scheme id="607" name="verticalresolutionrange" longName="Vertical Resolution Ranges" updateDate="2012-10-19"/> 
</schemes>


2.11 Concept Versions Resource

Returns a list of the version types of the concepts

URL

/version_type/

Method

GET

HTTP Accepts

  • application/xml

Path Params

  • versionType

Query Params


  • none

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • "application/xml"

Examples

Request for a list of all the past published versions of the keywords: https://gcmdservices.gsfc.nasa.gov/kms/concept_versions/version_type/past_published


<versions xsi:noNamespaceSchemaLocation="http://gcmd.gsfc.nasa.gov/Aboutus/xml/kms/kms.xsd"><version id="23" creation_date="2016-08-02" type="PAST_PUBLISHED">8.4.1</version><version id="19" creation_date="2016-07-07" type="PAST_PUBLISHED">8.4</version><version id="17" creation_date="2016-06-21" type="PAST_PUBLISHED">8.3</version><version id="15" creation_date="2016-06-07" type="PAST_PUBLISHED">8.2</version><version id="13" creation_date="2015-04-03" type="PAST_PUBLISHED">8.1</version><version id="7" creation_date="2013-04-15" type="PAST_PUBLISHED">8.0</version><version id="3" creation_date="2012-10-09" type="PAST_PUBLISHED">7.0</version><version id="1" creation_date="2012-06-12" type="PAST_PUBLISHED">Jun122012</version>
</versions>        }

Request for a list of the published version of the keywords: https://gcmdservices.gsfc.nasa.gov/kms/concept_versions/version_type/published


<versions xsi:noNamespaceSchemaLocation="http://gcmd.gsfc.nasa.gov/Aboutus/xml/kms/kms.xsd">
<version id="25" creation_date="2017-04-24" type="PUBLISHED">8.5</version
</versions>

Request a specific verison of the keywords
https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/sciencekeywords/?format=xml&version=8.4.1


2.12 Concepts In Concept Scheme Resource

Returns a list of all the concepts for a given scheme

URL

/concepts/concept_scheme/

Method

GET

HTTP Accepts

  • application/xml

Path Params

  • conceptScheme

Query Params


  • version

  • format

  • case

Form Params

  • none

HTTP Headers

  • Content-MD5

Returns

  • "application/xml"

  • “application/json”

  • “application/rdf+xml”

  • “text/csv”

Examples

 Request for the scheme 'Platforms': https://gcmdservices.gsfc.nasa.gov/kms/concepts/concept_scheme/platforms


<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:skos="http://www.w3.org/2004/02/skos/core#" xmlns:gcmd="http://gcmd.gsfc.nasa.gov/kms#">
 <gcmd:gcmd>
<gcmd:termsOfUse>http://gcmd.nasa.gov/r/l/TermsOfUse</gcmd:termsOfUse>
<gcmd:keywordVersion>8.5</gcmd:keywordVersion>
<gcmd:schemeVersion>2017-09-14 14:48:28</gcmd:schemeVersion>
</gcmd:gcmd>
 <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:skos="http://www.w3.org/2004/02/skos/core#" rdf:about="00274700-26c1-4c44-88a4-10a7ec6214de"xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
  
<skos:prefLabel xml:lang="en">GLONASS</skos:prefLabel>
 
<gcmd:altLabel gcmd:category="primary" gcmd:text="(GLObal NAvigation Satellite System)" xml:lang="en"/>
 
 <skos:definition xml:lang="en">
GLONASS or "Global Navigation Satellite System", is a space-based satellite navigation system operating in the radionavigation-satellite service. It provides an alternative to GPS and is the second navigational system in operation with global coverage and of comparable precision. Manufacturers of GPS devices say that adding GLONASS made more satellites available to them, meaning positions can be fixed more quickly and accurately, especially in built-up areas where the view to some GPS satellites is obscured by buildings. Smartphones generally tend to use the same chipsets and the versions used since 2015 receive GLONASS signals and positioning information along with GPS. Since 2012, GLONASS was the second most used positioning system in mobile phones after GPS. The system has the advantage that smartphone users receive a more accurate reception identifying location to within 2 meters.
</skos:definition>
 
<skos:broader rdf:resource="960f8eb8-6ca9-47d3-ae4a-7e21ebfad4c0"/>
 
 <skos:changeNote>
2017-08-15 09:58:44.0 [tstevens] update Definition (GLONASS or "Global Navigation Satellite System", is a space-based satellite navigation system operating in the radionavigation-satellite service. It provides an alternative to GPS and is the second navigational system in operation with global coverage and of comparable precision. Manufacturers of GPS devices say that adding GLONASS made more satellites available to them, meaning positions can be fixed more quickly and accurately, especially in built-up areas where the view to some GPS satellites is obscured by buildings. Smartphones generally tend to use the same chipsets and the versions used since 2015 receive GLONASS signals and positioning information along with GPS. Since 2012, GLONASS was the second most used positioning system in mobile phones after GPS. The system has the advantage that smartphone users receive a more accurate reception identifying location to within 2 meters.); update Definition (https://www.glonass-iac.ru/en/);
</skos:changeNote>
 
</skos:Concept>
 
 <skos:Concept xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:skos="http://www.w3.org/2004/02/skos/core#" rdf:about="00f8ab1f-040f-40b4-ba64-9f6a4c2ca7ed"xml:base="https://gcmdservices.gsfc.nasa.gov/kms/concept/">
 
 
<skos:prefLabel xml:lang="en">MICOM</skos:prefLabel>
 
<gcmd:altLabel gcmd:category="primary" gcmd:text="Miami Isopycnic Coordinate Ocean Model" xml:lang="en"/>
 
<skos:broader rdf:resource="113ecbc2-ab36-4d58-a96c-a6ce0106e749"/>
 
 <skos:changeNote>
2015-08-10 14:49:03.0 [epneff] added long name insert AltLabel (id: null text: Miami Isopycnic Coordinate Ocean Model language code: en);
</skos:changeNote>
 
 <skos:changeNote>
2015-08-10 14:48:31.0 [epneff] Insert Concept add broader relation (MICOM [00f8ab1f-040f-40b4-ba64-9f6a4c2ca7ed,158235] - Models/Analyses [113ecbc2-ab36-4d58-a96c-a6ce0106e749,143215]);
</skos:changeNote>
</skos:Concept>


3 Governance of Keywords

The Global Change Master Directory (GCMD) Keyword Governance and Community Guide Document, Version 1.0 provides the community with a comprehensive resource that describes the governance structures and process for reviewing proposed changes to the GCMD Keywords. The document includes an overview of the structure of the keywords, requirements and recommendations to consider when requesting keyword changes, and instructions for submitting change requests. The process described in this document will be the basis of all future GCMD Keyword reviews. The community is invited to provide feedback.

4 Keyword URLs

4.1 KMS API Capabilities

4.2 KMS Static Directory

4.3 Keywords Community Forum


5 Contact Us

If you have additional questions about the Keyword API, please contact us at: support@earthdata.nasa.gov. or post your question on the Keywords Community Forum.



  • No labels