|
|
| (62 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | <multilang>@en|
| |
| | | | |
| − | == 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 [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 ==
| |
| − |
| |
| − | To form a get query it would take the form of:
| |
| − | <pre>
| |
| − | https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}
| |
| − | </pre>
| |
| − |
| |
| − | e.g.:
| |
| − | <pre>
| |
| − | 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]
| |
| − | </pre>
| |
| − |
| |
| − | The valid search terms right now are:
| |
| − | <pre>
| |
| − | 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)
| |
| − | </pre>
| |
| − |
| |
| − | The search terms can be used together with AND and OR. There is also support for wildcards, free text searching and other operators:
| |
| − |
| |
| − | <pre>
| |
| − | Wildcard Description
| |
| − |
| |
| − | * any sequence of zero or more characters
| |
| − | ? any one character
| |
| − | </pre>
| |
| − |
| |
| − | <pre>
| |
| − | 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.
| |
| − | </pre>
| |
| − |
| |
| − | Heavily modeled after the ESA Data hubs so the following should apply:
| |
| − | https://colhub.copernicus.eu/userguide/OpenSearchAPI
| |
| − |
| |
| − | @fr|
| |
| − |
| |
| − | == Vue d'ensemble ==
| |
| − |
| |
| − | Le gouvernement du Canada s'est engagé à améliorer sa posture #OpenData, et cette nouvelle API est le dernier effort visant à s'aligner sur des géants tels que l'ESA et leur programme d'accès Sentinel afin d'améliorer l'accès à RADARSAT-1.
| |
| − |
| |
| − | == Exemples ==
| |
| − |
| |
| − | Pour former une requête get, cela prendrait la forme suivante:
| |
| − | <pre>
| |
| − | https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}
| |
| − | </pre>
| |
| − |
| |
| − | Par exemple:
| |
| − | <pre>
| |
| − | 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]
| |
| − | </pre>
| |
| − |
| |
| − | Les termes de recherche valides actuellement sont:
| |
| − | <pre>
| |
| − | producttype pouvant être SCN, SGF ou SLC pour Radarsat-1
| |
| − | sensoroperationalmode qui fait référence à la mnémonique du faisceau comme EH3, F1, W2, SCWB, SCNA, etc.
| |
| − | polarisationmode qui n'est que HH pour R1
| |
| − | ingestiondate
| |
| − | beginposition
| |
| − | endposition
| |
| − | footprint (point et polygon)
| |
| − | </pre>
| |
| − |
| |
| − | Les termes de recherche peuvent être utilisés avec AND et OR. Il existe également un support pour les caractères génériques, la recherche de texte libre et d'autres opérateurs:
| |
| − |
| |
| − | <pre>
| |
| − | Wildcard Description
| |
| − |
| |
| − | * any sequence of zero or more characters
| |
| − | ? any one character
| |
| − | </pre>
| |
| − |
| |
| − | <pre>
| |
| − | 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.
| |
| − | </pre>
| |
| − |
| |
| − | Ainsi, comme indiqué précédemment, il est fortement calqué sur les concentrateurs de données ESA:
| |
| − | https://colhub.copernicus.eu/userguide/OpenSearchAPI
| |
| − | </multilang>
| |