What is ECHO?

HTTP-based Search and Ordering Using ECHO’s REST and OpenSearch APIs

https://api.echo.nasa.gov/catalog-rest/catalog-docs/index.html

How Can I Use It? ECHO Facts

NASA’s Earth Observing System ClearingHOuse (ECHO) acts as the core metadata repository for NASA’s Earth Observing System Data and Information Systems data centers, providing a centralized mechanism for metadata and data discovery and retrieval. ECHO has recently made strides to restructure its API; allowing data partners to streamline and synchronize their metadata ingest using RESTful web services as well as providing an ESIP-compliant OpenSearch implementation.

• 3000+ Available Collections• Over 100 million Granules• 34 million ECHO hosted Browse Images• 2TB Data Index Covers Petabytes of Data• 60K+ registered users, utilizing EOSDIS URS• 13 Active Data Partners • Several Clients in Test & Evaluation• LANCE Near Real Time Data

ECHO and REST ECHO and OpenSearch

Documentation and Support

ECHO’s RESTful Data Discovery allows users to filter collections and granules based on keywords, spatial and temporal extent platforms, instruments, processing level, campaign, and many other fields. It also allows for the filtering of granules by collection-specific attributes.

Client developers can programmatically sort and page through both collection and granule results and may retrieve metadata in multiple formats including:•ECHO10•ISO19115 (preliminary)•JSON•Atom (+FROST)•csv (granules only)

ESIP Federated Search, based on the OpenSearch convention, is a simple framework for doing a federated query among participating members for Earth science data. ECHO provides standards-based access to its public catalog through an implementation of OpenSearch.

ECHO supports both the georss and time extensions as well as providing ECHO-specific extensions for fields such as line, point, instrument and provider name.

• http://earthdata.nasa.gov/echo

• http://earthdata.nasa.gov/library/echo-rest-search-guide

• http://wiki.esipfed.org/index.php/FederatedSearchConvention

• http://earthdata.nasa.gov/data/data-tools/data-catalog/

• echo@echo.nasa.gov

Why REST?•Scalable•Fault-tolerant•Recoverable•Secure•Loosely coupled•Ease of client development

OpenSearch Description Documents (OSDDs):https://api.echo.nasa.gov/echo-esip/echo-esip-dataset.xmlhttps://api.echo.nasa.gov/echo-esip/echo-esip-granule.xml

curl "https://api.echo.nasa.gov/echo-esip/search/granule.atom? clientId=esip-html-client& shortName=MOD02QKM&versionId=5& dataCenter=LAADS& boundingBox=-180.0%2C-90.0%2C180.0%2C90.0& startTime=2002-05-04T03A00-04%3A00& endTime=2009-05-04T00%3A00%3A00-04%3A00& numberOfResults=10&cursor=0"

OpenSearch cURL these links for OSDDs!

Example Granule Search Invocation:

HTML View OpenSearch

ECHO/NASA POC: andrew.e.mitchell@nasa.gov

curl –ig “https://api.echo.nasa.gov/catalog-rest/echo_catalog/granules?

platform[]=CALIPSO”

curl –ig “https://api-test.echo.nasa.gov/catalog-rest/echo_catalog/datasets.xml?polygon=5.273,33.724,15.82,9.796,51.68,1.406,73.477,30.145,43.242,40.447,5.273,33.724”

RESTful API

Example Granule Search Invocation:

Example Collection Search Invocation:

Authors: Katie Baynes (kathleen.baynes@nasa.gov), Dan Pilone (dan@element84.com), Jason Gilman (jason@element84.com),Doug Newman (douglas.j.newman@nasa.gov), Andrew Mitchell (andrew.e.mitchell@nasa.gov)

Visualizing a Polygon Search

ECHO Catalog

REST API

ReverbESIP

OpenSearch

MiradorGiovanni

…

DirectClients

Clie

nt D

ata

Retr

ieva

l

• Multi-format Retrieval• ECHO10• ISO 19115

• Searching• Ordering

ECHO’s REST API can also support search via GCMD Science Keywords and provides

ordering capabilities from some providers