Page History
Table of Contents | ||
---|---|---|
|
Element Description
The Location Keywords element contains keywords that characterize the study area/region where data was collected. This allows users to narrow their searches to areas that suit their geographic interest. The Location Keywords are chosen from a controlled keyword hierarchy maintained in the Keyword Management System (KMS). A list of valid Location Keywords can be found here: https://gcmdservicesgcmd.gsfcearthdata.nasa.gov/statickms/kmsconcepts/locationsconcept_scheme/locations.csv? ?format=csv.
Best Practices
Location keywords Keywords identify areas where data collection occurred and are provided in a hierarchical structure. The keywords can be chosen to classify broad study areas/regions or very specific places. However, it is suggested that location keywords are as specific as possible to aid in data discovery. Providing a Location Keyword is optional. If provided, a location category keyword the top level of the Location Keyword hierarchy must be provided (at a minimum). If a specific location keyword is not already included in the KMS, a request to have it added can be made through the through the GCMD Keywords Community Forum.
Examples:
LocationKeywords/Category: "CONTINENT"
LocationKeywords/Topic: "NORTH AMERICA"
LocationKeywords/Subregion1: "UNITED STATES"
LocationKeywords/Subregion2: "ALABAMA"LocationKeywords/Subregion3: "HUNTSVILLE"
LocationKeywords/DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
LocationKeywords/Category: "CONTINENT"
LocationKeywords/Topic: "NORTH AMERICA"
LocationKeywords/Subregion1: "CANADA"
LocationKeywords/Subregion2: "ONTARIO"
LocationKeywords/Category: "GEOGRAPHIC REGION"
LocationKeywords/Topic: "TROPICS"
Element Specification
Location Keywords are required. An unlimited amount of Providing a Location Keyword is optional. Multiple Location Keywords may be provided (, if necessary (Cardinality: 10..*).
Model | Element | Type | Usable Valid Values | Constraints | Required? | Cardinality | Notes |
---|---|---|---|---|---|---|---|
UMM-C | LocationKeywords/Category | String | Location Category Keywords | KMS controlled | Yes, if applicable | 1 | If a Location Keyword is included in the metadata (it's optional), then a Category keyword must be provided at a minimum. |
UMM-C | LocationKeywords/Type | String | Location Type Keywords | KMS controlled | No | 0..1 | |
UMM-C | LocationKeywords/Subregion1 | String | Location |
Subregion1 Keywords | KMS controlled | No | 0..1 | |
UMM-C | LocationKeywords/Subregion2 | String | Location |
Subregion2 Keywords | KMS controlled | No | 0..1 | |
UMM-C | LocationKeywords/Subregion3 | String |
KMS controlled | No | 0..1 | |||||
UMM-C | LocationKeywords/DetailedLocation | String | n/a | 1 - 80 characters (Uncontrolled/Free-Text) | No | 0..1 |
Metadata Validation and QA/QC
All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).
Lucidchart | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Please see the expandable sections below for flowchart details.
Expand | ||
---|---|---|
| ||
|
Expand | |||
---|---|---|---|
| |||
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
ARC Automated Checks
If no value isprovided, return is "np" |
Expand | ||
---|---|---|
| ||
<> |
Dialect Mappings
Expand | ||
---|---|---|
| ||
DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018) |
ARC Automated Checks ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information. |
Dialect Mappings
Expand | ||
---|---|---|
| ||
DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018) |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIF 10Providing a Location is optional. Multiple Locations may be provided, if necessary (Cardinality: 0..*).
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIF 10Location Keywords at the Category Level are required. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Specification | Path | Type | Constraints | Required in DIF 10? | Cardinality | Notes | DIF 10 | /DIF/Location_Keywords/Category | String | KMS controlled | Yes | 1 | DIF 10 | /DIF/Location_Keywords/Type | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Subregion_1 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Subregion_2 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Subregion_3 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Detailed_Location | String | 1 - 80 characters (Uncontrolled/Free-Text) | No | 0..1 | Example Mapping
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ECHO 10Location Keywords at the Category Level are required. Providing a Spatial Keyword is optional. Multiple Spatial Keywords may be provided, if necessary (Cardinality: 0..*).
Specification |
String | KMS controlled Yes | 1 | ECHO 10 |
/Collection/LocationKeywords/LocationKeyword/Subregion1Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/LocationKeywords/LocationKeyword/Subregion2Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/LocationKeywords/LocationKeyword/Subregion3Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/ScienceKeywords/LocationKeyword/DetailedLocationKeyword | String | Uncontrolled (Free-Text) | No | 0..1 |
|
Expand | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||
ISO 19115-2 MENDSProviding a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).
| |||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||
ISO 19115-2 MENDSLocation Keywords are not required.
|
Expand | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
ISO 19115-2 SMAPProviding a Location Keywords are not required.
|
UMM Migration
None
|
UMM Migration
None
Future Mappings
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
ISO 19115-1Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).
Example Mapping
|
Future Mappings
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
ISO 19115-1Location Keywords are not required. | |||||||||||||||||||||
Specification | Path | Type | Notes | ||||||||||||||||||
ISO 19115-1 | /mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/ mri:MD_Keywords/mri:keyword/gco:CharacterString (list each value of the keyword hierarchy delimited by > ) | String | KMS controlled. This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in between. The CMR will not translate the NONE values they are only used to place each keyword in its correct space in the hierarchy. | ||||||||||||||||||
ISO 19115-1 | /mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/ mri:MD_Keywords/mri:keyword/mri:type/mri:MD_KeywordTypeCode[@codeListValue="theme"] | Codelist | codeList=http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#MD_KeywordTypeCode Select the value "theme" from the codelist. This codelist value does not directly map to a UMM element; choosing "theme" indicates to CMR that the Science Keywords should be mapped. |
Section | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
History
UMM Versioning
History
UMM Versioning
Version | Date | What Changed |
---|---|---|
1.15.5 | 12/3/2020 | No changes were made for Location Keywords during the transition from version 1.15.4 to 1.15.5 |
1.15.4 | 9/18/2020 | No changes were made for Location Keywords during the transition from version 1.15.3 to 1.15.4 |
1.15.3 | 7/1/2020 | No changes were made for Location Keywords during the transition from version 1.15.2 to 1.15.3 |
1.15.2 | 5/20/2020 | No changes were made for Location Keywords during the transition from version 1.15.1 to 1.15.2 |
1.15.1 | 3/25/2020 | No changes were made for Location Keywords during the transition from version 1.15.0 to 1.15.1 |
1.15.0 | 2/26/2020 | No changes were made for Location Keywords during the transition from version 1.14.0 to 1.15.0 |
1.14.0 | 10/21/2019 | No changes were made for Location Keywords during the transition from version 1.13.0 to 1.14.0 |
1.13.0 | 04/11/2019 | No changes were made for Location Keywords during the transition from version 1.12.0 to 1.13.0 |
1.12.0 | 01/22/2019 | No changes were made for Location Keywords during the transition from version 1.11.0 to 1.12.0 |
1.11.0 | 11/28/2018 | No changes were made for Location Keywords during the transition from version 1.10.0 to 1.11.0 |
1.10.0 | 05/02/2018 | No changes were made for Location Keywords during the transition from version 1.9.0 to 1.10 |
. |
0 |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 502/401/182018 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space | Jeanne' le Roux |