Versions Compared

Old Version 16

changes.mady.by.user Jeanne' le Roux

Saved on

compared with

New Version Current

changes.mady.by.user Scott Ritz

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
stylecircle

Element Description

The Related URLs element, when accompanied by the 'get data' sub-elements, is used to link directly to a data access point. This is different from a GET USE SERVICE API URL, which relates to methods of sub-setting and/or transforming data before obtaining it. For details concerning GET USE SERVICE API URLs, please see the Related URLs (GET USE SERVICE API) wiki page. 

For general Related URL guidance (not specific to service data access links), please refer to the Related URLs wiki page.

Best Practices

The GET DATA Related URL metadata element allows for the linkage of a metadata record to a location on the web where data may be directly accessed. As mentioned on the Related URLs wiki page, there are several sub-elements which are used to identify the purpose of the URL. For GET DATA links specifically, best practices for these elements include:

URL Content Type: The URL Content Type is a keyword which, at a high level, describes the content of a link. This is a controlled vocabulary field maintained as an enumeration list within the UMM-Common schemaKeyword Management System (KMS). For GET DATA URLs, the URL Content Type should always be "DistributionURL".

URL Type: The URL Type is a keyword which specifies the content of a link. URL Type keywords are maintained in the Keyword Management System (KMS). For GET DATA URLs, the URL Type should always be "GET DATA".

URL Subtype: The URL Subtype is a keyword which further specifies the content of a link. Together, the URL Type and Subtype keywords create a keyword hierarchy which is used to identify the URL. Providing a Subtype for GET DATA URLs is optional, but should be used when applicable. Valid Subtypes include (as of 7/25/2018): <insert list> Should we include examples/ a brief description of each subtype?Subtype keywords can be found in the URL Content Type keyword list. For access links, any Subtype keyword after GET DATA is a valid option.

Description: While not required, it is highly recommended that a description be provided for each URL provided in the metadata. The description should be kept brief and explain to the user that the link goes to a data access point. The descriptions should be unique to the link. While descriptions can be repeated for the same type of URL across different metadata records, it is generally advised that the same description not be repeated within the same metadata record. I.e. the description should be used to further differentiate two GET DATA URLs with the same URL Type and Subtype. 

There are several sub-elements specifically designated for GET DATA URLs. The following provides definitions and best practices for each of the sub-elements:

RelatedUrls/GetData/Format: The format of the data provided via the associated URL. Format is an optional sub-field. Format is a controlled vocabulary field and should be chosen from the

<insert GCMD data format keyword list>

GCMD Data Format Keyword List. If data is provided in a compressed file format (e.g. .zip, .tar), it is recommended that the format of the data once it is uncompressed be provided.

   

    

RelatedUrls/GetData/MimeType:

The mime type of the associated URL. Mime Type is an optional sub-field. Mime Type is a controlled vocabulary field and should be chosen from the <insert GCMD mime type keyword list>.   

MIME stands for "Multipurpose Internet Mail Extensions". Mime types are used to identify the nature and format of files provided on the Internet, and are typically used by internet browsers in order to determine how to properly process or display a document or file. Providing the Mime Type element in the metadata helps ensure that the URL contents will be properly displayed on the Web. Mime Type is an optional sub-field. Mime Type is a controlled vocabulary field and should be chosen from the GCMD Mime Type Keyword list.

RelatedUrls/GetData/

Size

Fees: The

size of the data file(s) to be downloaded via the provided URL. Size should only be provided if clicking on the URL results in an immediate download. Size need not be provided if the user must perform additional tasks after clicking on the URL, such as navigating through a data directory before downloading data (since in this case, the size of the download may be variable).

fee (if any) for ordering the data. The fee should be a number in U.S. dollars. This is an optional field.  

The following GET DATA sub-elements only apply when the data access link is a direct download (i.e. when clicking on the URL results in an immediate download). For example, the following URL is a direct download (warning: clicking on this link will result in a file to be downloaded to your work space (203.6 MB). An Earthdata login is required to access the file): https://daac.ornl.gov/cgi-bin/download.pl?ds_id=1574&source=dsviewer 

These GET DATA sub-elements include:

RelatedUrls/GetData/Size: The purpose of this element is to inform

a user

users of the size of the data

to

that will be downloaded to their local work space if

clicking

they click on the data access URL

results in an immediate download

. This element only contains the numerical value of the size, not the unit. The unit (e.g. KB, MB, etc.) should be provided in the 'Unit' element.      

RelatedUrls/GetData/Unit: The unit accompanying the size specified in the 'Size' element. Together, Size and Unit indicate the size of the data file(s) to be downloaded via the provided URL. Unit must be provided if 'Size' is provided.

Size and Unit should only be provided if clicking on the URL results in an immediate download. Size and Unit need not be provided if the user must perform additional tasks after clicking on the URL, such as navigating through a data directory before downloading data (since in this case, the size of the download may be variable). This element should only contain a unit e.g. KB, MB, etc.

 Unit is a controlled vocabulary field and must be selected from the following options: KB, MB, GB, TB, PB. 

RelatedUrls/GetData/Checksum: A value used to verify the integrity of a file or a data transfer, such as the integrity of a downloaded file. The checksum provided in the metadata may be used to compare the original data file to the copy of the data downloaded to a user's local work space. The checksum provided in the metadata should be that of the original data file. The user is responsible for generating a checksum of the file on their local work space. If the checksum generated on their local work space does not match the checksum in the metadata (i.e. the original file), the data may have been altered or corrupted. Note that there are a variety of checksum algorithms available for use.

RelatedUrls/GetData/Fees: The fee (if any) for ordering the data. The fee should be a number in U.S. dollars. This is an optional field.  

RelatedUrls/GetData/Checksum: A value used to verify the integrity of a file or a data transfer, such as the integrity of a downloaded file. Checksum should only be provided if clicking on the URL results in an immediate download.  The checksum provided in the metadata may be used to compare the original data file to the copy of the data downloaded to a user's local work space via the data access URL. The checksum provided in the metadata should be that of the original data file. The user is responsible for generating a checksum of the file on their local work space - if the checksum generated on their local work space does not match the checksum in the metadata (i.e. the original file), the data may have been altered or corrupted. Note that there are a variety of checksum algorithms available for use.

Some examples include: MD5, CRC-8, CRC-16, CRC-32, Feltcher's checksum, Alder-32.  

For NASA EOSDIS data setsdatasets:

  • At least one GET DATA URL is required for all NASA data setsNASA EOSDIS datasets. 
  • For NASA EOSDIS data, data access should be behind URS authentication Earthdata Login authentication. 
  • For NASA EOSDIS data, it is also recommended that data access data access should not be provided via FTP protocol, in favor of the HTTPS protocol.


Examples:

URL: https://hydro1.gesdisc.eosdis.nasa.gov/data/FLDAS/FLDAS_VIC025_C_EA_M.001/

URL Content Type: DistributionURL

URL Type: GET DATA

URL Subtype: DATA TREE

Description: Use the link to access the data via HTTPS. Files are organized by date.

Format: NetCDF-4 

Mime Type: text/html 

Fees: 0


URL: https://daac.ornl.gov/cgi-bin/download.pl?ds_id=465&source=dsviewer

URL Content Type: DistributionURL

URL Type: GET DATA

URL Subtype: DIRECT DOWNLOAD

Description: Downloads the NPP Boreal Forest: Canal Flats, Canada, 1984, R1 data set dataset directly to your workstation. 

Format: Text File 

Size: 91.8

Unit: KB

Fees: 0

Checksum: f2aa78d6825ec42d783581a8d5ea1f 68


Element Specification

An unlimited amount of Related URLs may be listed (Cardinality: 0Related URLs is a required metadata element. It is required that a data access point be provided in the metadata as a GET DATA URL. Multiple data access URLs may be provided (Cardinality: 1..*).

ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-CommonRelatedUrls/URLStringn/a

1 - 1024 characters

Yes1The GET DATA URL should point the user to a location where data files may be directly downloaded.
UMM-CommonRelatedUrls/DescriptionStringn/a1 - 4000 charactersNo0..1It is strongly recommended that a description be provided for each URL.
UMM-CommonRelatedUrls/URLContentType
Enumeration

CollectionURL

PublicationURL

DataCenterURL

DistributionURL

DataContactURL

VisualizationURL
Keyword Management System (KMS)

DistributionURL

n/aYes1

"DistributionURL" is the only valid option for access links.

UMM-CommonRelatedUrls/TypeStringGET DATAKMS controlled
n/a
Yes1"GET DATA" should be provided as the Type.
UMM-CommonRelatedUrls/SubtypeStringGCMD URL Content Type 'Subtype' KeywordsKMS controlled
n/a
No0..1

The Type and Subtype are part of a keyword hierarchy specified in the KMS.

Any Subtype listed get after GET DATA in the keyword list is a valid option. If none of the available Subtypes are appropriate for the URL, then it is okay to leave the Subtype field blank.

UMM-CommonRelatedUrls/GetData/FormatStringGCMD Granule Data Format KeywordsKMS controlled
n/a
Yes1

The format of the data provided via the associated URL.

UMM-CommonRelatedUrls/GetData/MimeTypeString
KMS controlled
GCMD Mime Type Keywordsn/aNo0..1The mime type of the associated URL.
UMM-CommonRelatedUrls/GetData/SizeNumbern/an/aYes1

The size of the data obtained via the associated URL. Size should only be provided if clicking on the URL results in an immediate download.

UMM-CommonRelatedUrls/GetData/UnitEnumeration

KB

MB

GB

TB

PB

n/aYes1

Unit is required if information is provided in the 'Size' element. Size and Unit should only be provided if clicking on the URL results in an immediate download.

UMM-CommonRelatedUrls/GetData/FeesStringn/a1 - 80 charactersNo0..1

The fee (if any) for ordering the data. The fee should be a number in U.S. dollars.

UMM-CommonRelatedUrls/GetData/ChecksumStringn/a1 - 50 charactersNo0..1

Checksum should only be provided if clicking on the URL results in an immediate download. Note that there are a variety of checksum algorithms available for use.

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
rich-viewerfalse
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-51df84
width1102
pages-to-display
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details.


Expand
titleGCMD Metadata QA/QC


Expand
titleCMR Validation

<>

Expand
titleARC Metadata QA/QC

ARC Priority Matrix

element is provided, and follows all applicable criteria specified in the best practices section above.
Priority CategorizationJustification

This element is categorized as highest priority when:

  • A GET DATA URL is not provided in the metadata
  • The link labeled as GET DATA is broken
  • The link is mislabeled as GET DATA (i.e. the link serves a purpose other than data access)
  • The GET DATA link provides access to the incorrect dataset
  • The GET DATA link is labeled incorrectly (i.e. a data access link is provided in the metadata but it is labeled as something else)
  • The GET DATA link is provided via FTP
  • The GET DATA link fails to take the user as directly as possible to the described data
  • The URL Type or Subtype provided does not align with the KMS
    • The Type or Subtype does not exist in KMS
    • The Type or Subtype is placed in the incorrect position of the hierarchy (e.g. GET DATA should not be provided in the Subtype field, because it is categorized as a Type keyword in the KMS)
    • There is an invalid Type/Subtype relationship (e.g. Type: GET DATA, Subtype: USER'S GUIDE, is not a valid combination in the KMS)
  • The URL Type or Subtype provided does not accurately describe the link
  • The mime type provided is incorrect
  • The data format provided is incorrect

This element is categorized as medium priority when:

  • The 'Description' element is left blank for an existing URL. It is highly recommended that a description be provided for each URL.

This element is categorized as low priority when:

  • A description is repeated for multiple GET DATA URLs
  • The

ARC Automated Rules

URL: Information provided in the Related URLs/ URL element will be passed through the URL checker.

Description:

  • URL provided in the metadata redirects - it is recommended that the most current link always be provided
  • If a recommendation is made to add a new GET DATA URL to the metadata, there will be accompanying yellow recommendations to add the appropriate URLContentType/URLType/Subtype elements.
    • Note: These recommendations are blue at the granule level, since the schema does not require Related URLs at the granule level 

This element is categorized as low priority when:

  • A description is repeated for multiple GET DATA URLs
  • The GET DATA URL is provided via http when https is available

The element is provided and follows all applicable criteria specified in the best practices section above.

ARC Automated Rules

URL: Information provided in the Related URLs/ URL element will be passed through the URL checker.

Description:

Dialect Mappings

Dialect Mappings

Expand
titleDIF 9

DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018)

Expand
titleDIF 10

DIF 10

An unlimited amount of Related URLs may be listed (Cardinality: 0..*)

Related_URL is a required metadata element. It is required that a data access point be provided in the metadata as a GET DATA URL. 

UMM-C ElementDIF 10
Specification
PathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes
DIF 10
/DIF/

Related_URL/URL

URI



No

0..*

The GET DATA URL should point the user to a location where data files may be directly downloaded.

DIF 10/DIF//DIF/

Related_URL/URL_Content_Type/TypeStringGET DATA

KMS controlled

No0..1"GET DATA" should be provided as the Type.
DIF 10

Related_URL/URL_Content_Type/Subtype
StringGCMD URL Content Type 'Subtype' Keywords

KMS controlled


No0..1

The Type and Subtype are part of a keyword hierarchy specified in the KMS.

Any Subtype listed get after GET DATA in the keyword list is a valid option. If none of the available Subtypes are appropriate for the URL, then it is okay to leave the Subtype field blank.

DIF 10/DIF/

Related_URL/DescriptionString

No0..1It is strongly recommended that a description be provided for each URL.
DIF 10/DIF/

Related_URL/Mime_TypeStringGCMD Mime Type KeywordsKMS controlledNo0..1
DIF 10/DIF/Related


Related_URL/ProtocolString

No0..1
DIF 10/DIF/


Related_URL/TitleString

No0..1
DIF 10
/DIF/


Related_URL/Application_ProfileString

No0..1
DIF 10/DIF/


Related_URL/FunctionString

No0..1


Example Mapping

Section

DIF 10

Column
width50%
<Related_URL>
  <URL_Content_Type>
    <Type>GET DATA</Type>
    <Subtype>DATA TREE</Subtype>
  </URL_Content_Type>
  <URL>https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/</URL>
  <Mime_Type>text/html</Mime_Type>
  <Description>Use the link to navigate and download data files organized by date.</Description>
</Related_URL>
Column
width50%

UMM

No Format
RelatedUrls: [
  {
    Description: "Use the link to navigate and download data files organized by date.",
    URLContentType: "DistributionURL",
    Type: "GET DATA",
    Subtype: "DATA TREE",
    URL:  "https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/",
   -GetData: {
      MimeType: "text/html"
    }
  }
]
Expand
titleECHO 10

ECHO 10

An unlimited amount of Online Access URLs may be listed (Cardinality: 0..*)

Providing an Online Access URL is optional. However, it is strongly recommended that one be provided.

UMM-C ElementECHO 10
Specification
PathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotes
ECHO 10

/Collection/OnlineAccessURLs/OnlineAccessURL/URLString


No0..1

It is strongly recommended that an Online Access URL be provided. Providing an Online Access URL is required for NASA EOSDIS

data sets

datasets.

Note: there is no URL Type field provided in ECHO 10 for Online Access URLs. URLs provided in this element will automatically be labeled with the URL Type

of

'GET DATA' in CMR.

ECHO 10

/Collection/OnlineAccessURLs/OnlineAccessURL/URLDescriptionString


No0..1It is strongly recommended that a description be provided for each URL in the metadata.
ECHO 10

/Collection/OnlineAccessURLs/OnlineAccessURL/MimeTypeStringGCMD Mime Type Keywords
KMS controlledNo0..1


Enumeration Mapping

N/A

Example Mapping

Section
Column
width50%

ECHO 10

No Format
<OnlineAccessURLs>
  <OnlineAccessURL>
    <URL>https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/</URL>
    <URLDescription>Use the link to navigate and download data files organized by date.</URLDescription>
    <MimeType>text/html</MimeType>
  </OnlineAccessURL>
</OnlineAccessURLs>
Column
width50%

UMM

No Format
RelatedUrls: [
  {
    Description: "Use the link to navigate and download data files organized by date.",
    URLContentType: "DistributionURL",
    Type: "GET DATA",
    Subtype: "DATA TREE",
    URL:  "https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/",
   -GetData: {
      MimeType: "text/html"
    }
  }
]



Notes
Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

Related URLs is a required metadata element. It is required that a data access point be provided in the metadata as a GET DATA URL. Multiple data access URLs may be provided (Cardinality: 1..*).

Note: These ISO paths only apply to DistributionURLs. Please see the RelatedURLs wiki page for ISO guidance specific to other types of URLs.

UMM-C Element
SpecificationPathType

ISO 19115-2

MENDS

MENDS Path

TypeNotes


/gmi:MI_Metadata/gmd:

identificationInfo

distributionInfo/gmd:MD_

DataIdentification

Distribution/gmd:

citation

distributor/gmd:

CI

MD_

Citation

Distributor/ gmd:

identifier

distributorTransferOptions/gmd:MD

_Identifier

_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:

code

linkage/

gco

gmd:

CharacterString

URL

String


Where the

DOI string

access URL is provided.

Maps to the UMM element RelatedUrls/URL.

Note: This path only applies to DistributionURLs.


/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorTransferOptions/gmd:MD
_Identifier
_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:
codeSpace
description/gco:CharacterString=
gov.nasa.esdis.umm.doi
"Description: "
String

Maps to the UMM element RelatedUrls/Description. It is highly recommended that a description be provided for each URL.

* The character string should always start with the prefix "Description: " in order for CMR to properly parse out the URL description

StringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI

.


/gmi:MI_Metadata/gmd:

identificationInfo

distributionInfo/gmd:MD_

DataIdentification

Distribution/gmd:

citation

distributor/gmd:

CI

MD_

Citation

Distributor/ gmd:

identifier

distributorTransferOptions/gmd:MD_

Identifier

DigitalTransferOptions/gmd:

descriptionISO 19115-2 MENDS

onLine/

gco:CharacterString contains DOIStringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI.

gmd:CI_OnlineResource/gmd:description/gco:CharacterString="URLContentType: DistributionURL"

String

Maps to the UMM element RelatedUrls/URLContentType. Providing the URL Content Type is required in CMR.

* For data access links, the character string should always read "URLContentType: DistributionURL"


/gmi:MI_Metadata/gmd:

identificationInfo

distributionInfo/gmd:MD_

DataIdentification

Distribution/gmd:

citation

distributor/gmd:

CI

MD_

Citation

Distributor/ gmd:

identifier

distributorTransferOptions/gmd:MD_

Identifier

DigitalTransferOptions/gmd:

authority

onLine/gmd:CI_

Citation

OnlineResource/gmd

:title - empty element

:description/gco:CharacterString="Type: GET DATA"

String

Leave this element empty.

Maps to the UMM element RelatedUrls/Type. Providing the URL Type is required in CMR.

* For data access links, the character string should always read "Type: GET DATA"


/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorTransferOptions/gmd:MD_
Identifier
DigitalTransferOptions/gmd:
authority
onLine/gmd:CI_
Citation
OnlineResource/gmd
:date - empty element
:description/gco:CharacterString="Subtype: "
String
Leave this element empty./gmi:

Maps to the UMM element RelatedUrls/Subtype. Providing a URL Subtype is optional, but is encouraged if an appropriate URL Subtype exists. URL Subtype is a GCMD controlled vocabulary field and must be selected from keywords in the KMS. Please see the best practices section (above) on guidance on choosing the correct URL Subtype.

* The character string should always start with with the prefix "Subtype: " in order for CMR to properly parse out the URL Subtype.


/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorFormat/gmd:MD_
Identifier
Format/gmd:
authority
name/
gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString 
gco:CharacterString ="MimeType: "String
Provide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority./gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority/gmd:CI_Citation/ gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="" = authorityCodelistChoose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped.

Enumeration/Code List Mapping

ISO MENDS

Translation

Direction

UMMinapplicable↔Not Applicable

Maps to the UMM element RelatedUrls/GetData/MimeType. Providing a mime type is optional. Mime Type is a GCMD controlled vocabulary field and should be selected from keywords in the KMS.

* The character string should always start with with the prefix "MimeType: " in order for CMR to properly parse out the mime type.


Enumeration/Code List Mapping

N/A

Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
<gmi:MI_Metadata>
...
  <gmd:distributionInfo>
  <gmd:MD_Distribution>
    <gmd:distributor>
    <gmd:MD_Distributor>
      <gmd:distributorFormat>
        </gmd:MD_Format>
          <gmd:name>
            <gco:CharacterString>MimeType: text/html</gco:CharacterString>
          </gmd:name>
        </gmd:MD_Format>
      </gmd:distributorFormat>
    <gmd:distributorTransferOptions>
      <gmd:MD_DigitalTransferOptions>
        <gmd:onLine>
          <gmd:CI_OnlineResource>
            <gmd:linkage>
              <gmd:URL>https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/</gmd:URL>
            </gmd:linkage>
            <gmd:description>
              <gco:CharacterString>Description:

Example Mapping

Section

ISO 19115-2 MENDS

Column
width50%
No Format
Column
width50%

UMM

No Format
RelatedUrls: [
  {
    Description: "Use the link to navigate and download data files organized by date.",
    URLContentType: "DistributionURL",
    Type: "GET DATA",
    Subtype: "DATA TREE",TREE</gco:CharacterString>
    URL:  "https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/",
   -GetData: {
   </gmd:description>
   MimeType: "text/html"
    }
  }
]
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

SpecificationPathTypeNotesISO 19115-2 SMAP
  </gmd:
DS_Series
CI_OnlineResource>
        </gmd:
seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo
onLine>
      </gmd:MD_DigitalTransferOptions>
    </gmd:distributorTransferOptions>
    </gmd:MD_
DataIdentification/gmd:citation
Distributor>
    </gmd:
CI_Citation/gmd:identifier
distributor>
  </gmd:MD_
Identifier
Distribution>
  </gmd:distributionInfo>
...
</gmi:MI_Metadata>
Column
width50%

UMM

No Format
RelatedUrls: [
  {
    Description: "Use the link to navigate and download data files organized by date.",
    URLContentType: "DistributionURL",
    Type: "GET DATA",
    Subtype: "DATA TREE",
    URL:  "https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/",
   -GetData: {
      MimeType: "text/html"
    }
  }
]



/
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

Related URLs is a required metadata element. It is required that a data access point be provided in the metadata as a GET DATA URL. Multiple data access URLs may be provided (Cardinality: 1..*).

Note: These ISO paths only apply to DistributionURLs. Please see the RelatedURLs wiki page for ISO guidance specific to other types of URLs.

code/gco:CharacterString

String

Where the DOI string is provided.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.doiStringThe value of "gov.nasa.esdis.umm.doi" should be provided here so that CMR can properly parse out the DOI.
/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString contains DOIStringThe value must contain the string "DOI" so that CMR can properly identify and translate the DOI.
ISO 19115-2 SMAP
UMM-C Element

ISO 19115-2 SMAP Path

TypeNotes

gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:

identificationInfo

distributionInfo/gmd:MD_

DataIdentification

Distribution/gmd:

citation

distributor/gmd:

CI

MD_

Citation

Distributor/ gmd:

identifier

distributorTransferOptions/gmd:MD_

Identifier

DigitalTransferOptions/gmd:

authority

onLine/gmd:CI_

Citation

OnlineResource/gmd:linkage/gmd:

title - empty element

URL

String

Leave this element empty.

/


Where the access URL is provided.

Maps to the UMM element RelatedUrls/URL.

Note: This path only applies to DistributionURLs.


gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorTransferOptions/gmd:MD_
Identifier
DigitalTransferOptions/gmd:
authority
onLine/gmd:CI_
Citation
OnlineResource/gmd:
date - empty element
description/gco:CharacterString="Description: "
String
Leave this element empty./

Maps to the UMM element RelatedUrls/Description. It is highly recommended that a description be provided for each URL.

* The character string should always start with the prefix "Description: " in order for CMR to properly parse out the URL description.


gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorTransferOptions/gmd:MD_
Identifier
DigitalTransferOptions/gmd:
authority
onLine/gmd:CI_
Citation
OnlineResource/gmd:
citedResponsibleParty
description/
gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString StringProvide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority./
gco:CharacterString="URLContentType: DistributionURL"String

Maps to the UMM element RelatedUrls/URLContentType. Providing the URL Content Type is required in CMR.

* For data access links, the character string should always read "URLContentType: DistributionURL"


gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:
identificationInfo
distributionInfo/gmd:MD_
DataIdentification
Distribution/gmd:
citation
distributor/gmd:
CI
MD_
Citation
Distributor/ gmd:
identifier
distributorTransferOptions/gmd:MD_
Identifier
DigitalTransferOptions/gmd:
authority
onLine/gmd:CI_
Citation
OnlineResource/gmd:
citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="" = authorityCodelistChoose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped.
Enumeration/Code List MappingISO SMAP

Translation

Direction

UMMinapplicable↔Not Applicable

Example Mapping

Section Column
width50%

ISO 19115-2 SMAP

No Format
Column
width50%

UMM

No Format
RelatedUrls: [
  {
    Description: "Use the link to navigate and download data files organized by date.",
    URLContentType: "DistributionURL",
    Type: "GET DATA",
    Subtype: "DATA TREE",
    URL:  "https://oco2.gesdisc.eosdis.nasa.gov/data/s4pa/OCO2_DATA/OCO2_L2_Met.8r/",
   -GetData: {
      MimeType: "text/html"
    }
  }
]