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/
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: [email protected]
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 ([email protected]), Dan Pilone ([email protected]), Jason Gilman ([email protected]),Doug Newman ([email protected]), Andrew Mitchell ([email protected])
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
Top Related