Difference between revisions of "EODMS APIs"

From wiki
Jump to: navigation, search
m (William.mackinnon moved page EODMS Open Search API (BETA) to EODMS Open Search API: Remove beta)
Line 3: Line 3:
 
== Overview ==
 
== Overview ==
  
As part of the [https://www.tbs-sct.gc.ca/pol/doc-eng.aspx?id=28108 Directive on Open Government], the Government of Canada is committed improving its #OpenData posture. This OpenSearch API is the latest effort to align the [[Earth Observation Data Management System (EODMS)]] with giants like ESA and their Sentinel access program to improve RADARSAT-1 access
+
As part of the [https://www.tbs-sct.gc.ca/pol/doc-eng.aspx?id=28108 Directive on Open Government], the Government of Canada is committed improving its [https://twitter.com/hashtag/opendata?lang=en #OpenData] posture. This OpenSearch API is the latest effort to align the [[Earth Observation Data Management System (EODMS)]] with giants like ESA and their Sentinel access program to improve RADARSAT-1 access
  
 
== Examples ==  
 
== Examples ==  

Revision as of 17:08, 1 November 2019


Overview[edit | edit source]

As part of the Directive on Open Government, the Government of Canada is committed improving its #OpenData posture. This OpenSearch API is the latest effort to align the Earth Observation Data Management System (EODMS) with giants like ESA and their Sentinel access program to improve RADARSAT-1 access

Examples[edit | edit source]

To form a get query it would take the form of:

https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}

e.g.:

https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=footprint:Intersects((-130.496,54.672))
https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=beginposition:[2007-08-20T00:49:50Z%20TO%202007-08-22T10:50:50Z]

The valid search terms right now are:

producttype which can be SCN,SGF, or SLC for Radarsat-1
sensoroperationalmode which refers to the beam mnemonic like EH3, F1, W2, SCWB, SCNA etc..
polarisationmode which is only HH for R1
ingestiondate
beginposition
endposition
footprint  (point and polygon)

The search terms can be used together with AND and OR. There is also support for wildcards, free text searching and other operators:

Wildcard	Description

*		any sequence of zero or more characters
?		any one character
Operator	Description

AND	        Narrow search and retrieve records containing all of the words it separates.
OR		Broaden search and retrieve records containing any of the words it separates.
NOT		Narrow search and retrieve records that do not contain the term following it.
( )		Group words or phrases when combining Boolean phrases and to show the order in which relationships should be considered.

Heavily modeled after the ESA Data hubs so the following should apply: https://colhub.copernicus.eu/userguide/OpenSearchAPI