Line 1: |
Line 1: |
− | <multilang>@en|
| + | == Overview == |
| | | |
− | EODMS is has several options for API Access and automation i.e. Machine 2 Machine. To find more GC APIs, visit the GC API site. | + | [[Earth_Observation_Data_Management_System_(EODMS)|EODMS]] has several options for search and download API access as well as automation i.e. Machine 2 Machine. |
| + | |
| + | 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 to improving its [https://twitter.com/hashtag/opendata?lang=en #OpenData] posture. EODMS API access aims to promote practices per the [https://www.canada.ca/en/government/system/digital-government/modern-emerging-technologies/government-canada-standards-apis.html GC Standards on APIs] |
| + | |
| + | To find more GC APIs, visit the GC API site. |
| | | |
| [[File:Api-logo.png|link=https://api.canada.ca/en/homepage]] | | [[File:Api-logo.png|link=https://api.canada.ca/en/homepage]] |
| https://api.canada.ca/en/homepage | | https://api.canada.ca/en/homepage |
| | | |
− | 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 to improving its [https://twitter.com/hashtag/opendata?lang=en #OpenData] posture. EODMS API access aims to promote practices per the [https://www.canada.ca/en/government/system/digital-government/modern-emerging-technologies/government-canada-standards-apis.html GC Standards on APIs]
| + | === GitHub Repo - Search and Discovery in Python === |
| + | |
| + | Checkout out our [https://github.com/nrcan-eodms-sgdot-rncan/eodms-ogc-client-py/wiki open source Python module on GitHub] which uses the CSW, WCS and REST APIs to automate the ordering of images from EODMS. |
| + | |
| + | == REST API == |
| + | |
| + | === REST Search === |
| + | |
| + | SEARCH FIELDS |
| + | |
| + | Default result format is human-readable HTML. Appending <code>&format=json'</code> or <code>'=xml'</code> to the URL behaves as expected. |
| + | Each collection has a unique set of search fields here: |
| + | https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/collections/NAPL |
| + | https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/collections/RCMImageProducts |
| + | https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/collections/Radarsat1 |
| + | |
| + | SPATIAL |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/search?collection=NAPL&query=CATALOG_IMAGE.THE_GEOM_4326 INTERSECTS POLYGON ((-75 45,-75 46,-76 46,-76 45,-75 45))&format=json</pre> |
| + | |
| + | TEMPORAL |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/search?collection=NAPL&query=CATALOG_IMAGE.START_DATETIME>'2000-01-01' AND CATALOG_IMAGE.START_DATETIME<'2005-01-01'</pre> |
| + | |
| + | BOOLEAN |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/search?collection=NAPL&query=CATALOG_IMAGE.PUBLIC_GOOD=TRUE</pre> |
| + | |
| + | STRING |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/search?collection=NAPL&query=ROLL.ROLL_NUMBER='A128' AND PHOTO.PHOTO_NUMBER='0032</pre> |
| + | |
| + | === REST Order === |
| + | |
| + | URL: https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/order |
| + | |
| + | HTTP AUTH: Your EODMS username and password |
| + | |
| + | HTTP POST XML: |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| + | { |
| + | "destinations": [], |
| + | "items": [ |
| + | { |
| + | "collectionId": "RCMImageProducts", |
| + | "recordId": "7189214" |
| + | } |
| + | ] |
| + | } |
| + | </pre> |
| + | |
| + | == OPENSEARCH API == |
| + | |
| + | === OPENSEARCH Search === |
| + | |
| + | BASIC |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| + | https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/opensearch/search?q=* |
| + | </pre> |
| + | |
| + | SPATIAL |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| + | https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/opensearch/search?q=*&bbox=-75.71,45.42,-75.69,45.43 |
| + | </pre> |
| | | |
− | == OpenSearch API (for RADARSAT-1 and NAPL) == | + | === OPENSEARCH Order === |
| | | |
− | This OpenSearch API is the latest effort to align with giants like ESA and their [[https://scihub.copernicus.eu/userguide/OpenSearchAPI Copernicus Data Hub OpenSearch access program]] to improve RADARSAT-1 access
| + | Using a RESPONSE from the OPENSEARCH Search, you can parse out the <code style="background-color:#EEFFCC; border-color:#AACC99">collectionId</code> and <code style="background-color:#EEFFCC; border-color:#AACC99">recordId</code> and submit a corresponding [[#REST Order|REST Order]]. e.g. <code style="background-color:#EEFFCC; border-color:#AACC99">collectionId=Radarsat1</code> and <code style="background-color:#EEFFCC; border-color:#AACC99">recordId=1508207</code> |
| | | |
− | To form a get query it would take the form of:
| + | <pre> |
| + | { |
| + | "results": [ |
| + | { |
| + | "recordId": "1508207", |
| + | "overviewUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/getObject?FeatureID=SERVICE-RSAT1_001-000000000000000000-1508207&ObjectType=Overview&collectionId=Radarsat1", |
| + | "collectionId": "Radarsat1", |
| + | "metadata2": [ |
| + | { |
| + | "id": "REASON", |
| + | "value": "", |
| + | "label": "Reason" |
| + | }, |
| + | { |
| + | "id": "ARCHIVE_IMAGE.PRODUCT_TYPE", |
| + | "value": "SLC", |
| + | "label": "Type" |
| + | }, |
| + | { |
| + | "id": "RSAT1.SBEAMFULL", |
| + | "value": "Fine 2", |
| + | "label": "Beam Mode" |
| + | }, |
| + | { |
| + | "id": "IDX_SENSOR.SENSOR_NAME", |
| + | "value": "RADARSAT-1", |
| + | "label": "Satellite" |
| + | }, |
| + | { |
| + | "id": "CATALOG_IMAGE.START_DATETIME", |
| + | "value": "2007-12-18 22:55:39 UTC", |
| + | "label": "Date" |
| + | }, |
| + | { |
| + | "id": "RELATED_PRODUCTS", |
| + | "value": "{\"headers\":[\"Product Type\",\"LUT_APPLIED\",\"Sampled Pixel Spacing (Panchromatic)\",\"Product Format\",\"Geodetic Terrain Height\"],\"relatedProducts\":[{\"values\":[\"SLC\",\"Unity\",\"4.638299\",\"CEOS\",\"0.0\"]}],\"collectionID\":\"Radarsat1\",\"imageID\":\"1508207\"}", |
| + | "label": "Image Info" |
| + | }, |
| + | { |
| + | "id": "Metadata", |
| + | "value": "dummy value", |
| + | "label": "Metadata" |
| + | }, |
| + | { |
| + | "id": "CATALOG_IMAGE.STATUS", |
| + | "value": "", |
| + | "label": "Status" |
| + | }, |
| + | { |
| + | "id": "RSAT1.POLARIZATION", |
| + | "value": "HH", |
| + | "label": "Polarization" |
| + | } |
| + | ], |
| + | "rapiOrderUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/order/direct?collection=Radarsat1&recordId=1508207&destination=fill_me_in", |
| + | "title": "RS1_M0630930_F2N_20071218_225547_HH_SLC", |
| + | "orderExecuteUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/Client/?entryPoint=preview#?cseq=Radarsat1&record=1508207", |
| + | "thumbnailUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/getObject?FeatureID=SERVICE-RSAT1_001-000000000000000000-1508207&ObjectType=Thumbview&collectionId=Radarsat1", |
| + | "metadataUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/Client/?entryPoint=resultDetails&resultId=1508207&collectionId=Radarsat1", |
| + | "isGeorectified": false, |
| + | "collectionTitle": "RADARSAT-1 Open Data Products", |
| + | "isOrderable": true, |
| + | "thisRecordUrl": "https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/record/Radarsat1/1508207", |
| + | "metadata": [ |
| + | [ |
| + | "Reason", |
| + | "" |
| + | ], |
| + | [ |
| + | "Type", |
| + | "SLC" |
| + | ], |
| + | [ |
| + | "Beam Mode", |
| + | "Fine 2" |
| + | ], |
| + | [ |
| + | "Satellite", |
| + | "RADARSAT-1" |
| + | ], |
| + | [ |
| + | "Date", |
| + | "2007-12-18 22:55:39 UTC" |
| + | ], |
| + | [ |
| + | "Image Info", |
| + | "{\"headers\":[\"Product Type\",\"LUT_APPLIED\",\"Sampled Pixel Spacing (Panchromatic)\",\"Product Format\",\"Geodetic Terrain Height\"],\"relatedProducts\":[{\"values\":[\"SLC\",\"Unity\",\"4.638299\",\"CEOS\",\"0.0\"]}],\"collectionID\":\"Radarsat1\",\"imageID\":\"1508207\"}" |
| + | ], |
| + | [ |
| + | "Metadata", |
| + | "dummy value" |
| + | ], |
| + | [ |
| + | "Status", |
| + | "" |
| + | ], |
| + | [ |
| + | "Polarization", |
| + | "HH" |
| + | ] |
| + | ] |
| + | } |
| + | ... |
| + | </pre> |
| + | == OPENSEARCH API. Copernicus Hub Inspired. Provides Direct Download. RADARSAT-1 and NAPL, ONLY) == |
| | | |
− | <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}</code>
| + | This particular flavour of OpenSearch API is heavily modeled after the [[https://scihub.copernicus.eu/userguide/OpenSearchAPI Copernicus Data Hub OpenSearch access program]] to align RADARSAT-1 and NAPL access with SENTINEL access. Each API response comes with a direct download URL (in contrast to the [[#REST Order|REST Order]] API call which invokes a slower archive-pull-and-stage operation. |
| | | |
− | e.g.:
| + | QUERY FORMAT |
| | | |
− | <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=footprint:Intersects((-130.496,54.672))</code> | + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}</code> |
| | | |
− | <pre>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> | + | QUERY EXAMPLES |
| + | |
| + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=footprint:Intersects((-130.496,54.672))</code> |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99">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> |
| | | |
| SEARCH TERMS | | SEARCH TERMS |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| producttype which can be SCN,SGF, or SLC for Radarsat-1 | | 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.. | | sensoroperationalmode which refers to the beam mnemonic like EH3, F1, W2, SCWB, SCNA etc.. |
Line 36: |
Line 214: |
| The search terms can be used together with AND and OR. There is also support for wildcards, free text searching and other operators: | | The search terms can be used together with AND and OR. There is also support for wildcards, free text searching and other operators: |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
− | Wildcard Description | + | Wildcard Description |
| | | |
− | * any sequence of zero or more characters | + | * any sequence of zero or more characters |
− | ? any one character | + | ? any one character |
| </pre> | | </pre> |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
− | Operator Description | + | Operator Description |
| | | |
− | AND Narrow search and retrieve records containing all of the words it separates. | + | 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. | + | 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. | + | 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. | + | ( ) Group words or phrases when combining Boolean phrases and to show the order in which relationships should be considered. |
| </pre> | | </pre> |
| | | |
Line 55: |
Line 233: |
| <code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code> | | <code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code> |
| | | |
− | == OGC APIs== | + | == OGC APIs == |
| | | |
− | See [[File:EODMS OGC Services.pdf|none]] for complete details as well as an end-to-end sample.
| + | The following are usage samples of EODMS' OGC APIs with a full [https://github.com/nrcan-eodms-sgdot-rncan/eodms-ogc-client-py/wiki open source Python module on GitHub] |
| | | |
− | === CSW GetRecords === | + | === Discover some data / CSW GetRecords === |
| | | |
| URL (POST) | | URL (POST) |
| | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog</code>
| + | Each data collection has a separate URL. The following are supported: |
| | | |
− | HTTP POST - HEADER | + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog</code> |
| + | |
| + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_napl_catalog</code> |
| + | |
| + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/RCMImageProducts</code> |
| + | |
| + | HTTP POST - HEADER (No Username/Password) |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| + | <csw:GetRecords service='CSW' version='2.0.2' maxRecords='10' startPosition='1' resultType='results' |
| + | 	outputFormat='application/xml' outputSchema='http://www.opengis.net/cat/csw/2.0.2' |
| + | 	xmlns='http://www.opengis.net/cat/csw/2.0.2' xmlns:csw='http://www.opengis.net/cat/csw/2.0.2' |
| + | 	xmlns:ogc='http://www.opengis.net/ogc' xmlns:ows='http://www.opengis.net/ows' |
| + | 	xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:dct='http://purl.org/dc/terms/' |
| + | 	xmlns:gml='http://www.opengis.net/gml' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' |
| + | 	xsi:schemaLocation='http://www.opengis.net/cat/csw/2.0.2 http://schemas.opengis.net/csw/2.0.2/CSW-discovery.xsd'> |
| + | 	<csw:Query typeNames='csw:Record'> |
| + | 		<csw:ElementSetName typeNames='csw:Record'>summary</csw:ElementSetName> |
| + | 	</csw:Query> |
| + | </csw:GetRecords> |
| + | </pre> |
| + | |
| + | HTTP POST - HEADER (With Username/Password SOAP Envelope) |
| + | |
| + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| + | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> |
| + | <soapenv:Header> |
| + | <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> |
| + | <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/ oasis-200401-wss-wssecurity-utility-1.0.xsd"> |
| + | <wsse:Username>#####</wsse:Username> |
| + | <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">#####</wsse:Password> |
| + | </wsse:UsernameToken> |
| + | </wsse:Security> |
| + | </soapenv:Header> |
| + | <soapenv:Body> |
| | | |
− | <pre><csw:GetRecords service='CSW' version='2.0.2' maxRecords='10' startPosition='1' resultType='results'
| + | <csw:GetRecords service='CSW' version='2.0.2' maxRecords='10' startPosition='1' resultType='results' |
| 	outputFormat='application/xml' outputSchema='http://www.opengis.net/cat/csw/2.0.2' | | 	outputFormat='application/xml' outputSchema='http://www.opengis.net/cat/csw/2.0.2' |
| 	xmlns='http://www.opengis.net/cat/csw/2.0.2' xmlns:csw='http://www.opengis.net/cat/csw/2.0.2' | | 	xmlns='http://www.opengis.net/cat/csw/2.0.2' xmlns:csw='http://www.opengis.net/cat/csw/2.0.2' |
Line 77: |
Line 289: |
| 		<csw:ElementSetName typeNames='csw:Record'>summary</csw:ElementSetName> | | 		<csw:ElementSetName typeNames='csw:Record'>summary</csw:ElementSetName> |
| 	</csw:Query> | | 	</csw:Query> |
− | </csw:GetRecords></pre> | + | </csw:GetRecords> |
| + | |
| + | </soapenv:Body> |
| + | </soapenv:Envelope> |
| + | </pre> |
| | | |
| HTTP RESPONSE | | HTTP RESPONSE |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| <?xml version="1.0" encoding="UTF-8"?> | | <?xml version="1.0" encoding="UTF-8"?> |
| <GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"> | | <GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"> |
Line 127: |
Line 343: |
| </pre> | | </pre> |
| | | |
− | === CSW GetRecordById === | + | === Fetch a Single Record / CSW GetRecordById === |
| | | |
− | URL (GET Request) | + | URL (GET REQUEST) |
| | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog?request=GetRecordById&id=1515826&service=CSW&version=2.0.2</code> | + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog?request=GetRecordById&id=1515826&service=CSW&version=2.0.2</code> |
| | | |
| HTTP RESPONSE | | HTTP RESPONSE |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| <GetRecordByIdResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"> | | <GetRecordByIdResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"> |
| 	<csw:SummaryRecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" | | 	<csw:SummaryRecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" |
Line 172: |
Line 388: |
| </pre> | | </pre> |
| | | |
− | == Katalon == | + | === Order that Record / WCS DescribeCoverage === |
| | | |
− | * A [https://github.com/nrcan-eodms-sgdot-rncan/eodms-scene-retriever Katalon utility] to automate website user clicks for searching and ordering.
| + | The WCS DescribeCoverage message is used for ordering and can be sent as a POST or GET (recommended) request. |
| | | |
− | @fr|
| + | URL (GET REQUEST) |
| | | |
− | SGDOT propose plusieurs options pour l’API Access et automation, à savoir Machine 2 Machine. Pour découvrir plus d’API du GC, visitez le site API du GC.
| + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs?SERVICE=WCS&version=2.0.1&REQUEST=DescribeCoverage&coverageId=5117806&CollectionId=Radarsat1</code> |
| | | |
− | [[File:Api-logo.png|link=https://api.canada.ca/en/homepage]]
| + | URL (POST) |
− | https://api.canada.ca/en/homepage
| |
− | | |
− | Dans le cadre de la [https://www.tbs-sct.gc.ca/pol/doc-fra.aspx?id=28108 Directive sur la gouvernance ouverte], le gouvernement du Canada s'est engagé à améliorer sa [https: // twitter.com/hashtag/opendata?lang=en #OpenData] posture. API EODMS [http://www.canada.ca/fr/government/system/digital-government/modern-emerging-technologies/government-canada-standards-apis.html Normes du GC sur les API]
| |
− | | |
− | == API OpenSearch (pour RADARSAT-1 et NAPL) ==
| |
− | | |
− | Pour former une requête get, cela prendrait la forme suivante:
| |
− | <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}</code>
| |
− | | |
− | Par exemple:
| |
− | | |
− | <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=footprint:Intersects((-130.496,54.672))</code>
| |
− | | |
− | <pre>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>
| |
− | | |
− | Termes de recherche
| |
− | | |
− | <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
| + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code> |
− | ? 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:
| |
− | <code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code> | |
− | | |
− | == OGC == | |
− | | |
− | * API compatibles OGC: CSW pour la recherche et WCS pour la commande. Voir [[File:EODMS OGC Services.pdf|none]] pour plus d'informations.
| |
− | | |
− | === CSW GetRecords ===
| |
− | | |
− | URL
| |
− | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog</code>
| |
| | | |
| HTTP POST - HEADER | | HTTP POST - HEADER |
| | | |
− | <pre><csw:GetRecords service='CSW' version='2.0.2' maxRecords='10' startPosition='1' resultType='results' | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"><wcs:DescribeCoverage service="WCS" version="2.0.1" |
− | 	outputFormat='application/xml' outputSchema='http://www.opengis.net/cat/csw/2.0.2' | + | 	xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' |
− | 	xmlns='http://www.opengis.net/cat/csw/2.0.2' xmlns:csw='http://www.opengis.net/cat/csw/2.0.2' | + | 	xsi:schemaLocation="http://www.opengis.net/wcs/2.0 |
− | 	xmlns:ogc='http://www.opengis.net/ogc' xmlns:ows='http://www.opengis.net/ows' | + | 	http://schemas.opengis.net/wcs/2.0/wcsAll.xsd" |
− | 	xmlns:dc='http://purl.org/dc/elements/1.1/' xmlns:dct='http://purl.org/dc/terms/'
| + | 	xmlns="http://www.opengis.net/wcs/2.0" |
− | 	xmlns:gml='http://www.opengis.net/gml' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' | + | 	xmlns:wcs="http://www.opengis.net/wcs/2.0"> |
− | 	xsi:schemaLocation='http://www.opengis.net/cat/csw/2.0.2 http://schemas.opengis.net/csw/2.0.2/CSW-discovery.xsd'> | + | 	<wcs:CoverageId>Radarsat1--5117806</wcs:CoverageId> |
− | 	<csw:Query typeNames='csw:Record'> | + | </wcs:DescribeCoverage></pre> |
− | 		<csw:ElementSetName typeNames='csw:Record'>summary</csw:ElementSetName>
| |
− | 	</csw:Query>
| |
− | </csw:GetRecords></pre> | |
| | | |
| HTTP RESPONSE | | HTTP RESPONSE |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"><wcs:CoverageDescriptions xmlns:wcs="http://www.opengis.net/wcs/2.0"> |
− | <?xml version="1.0" encoding="UTF-8"?> | + | 	<wcs:CoverageDescription xmlns:gml="http://www.opengis.net/gml/3.2" |
− | <GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"> | + | 		gml:id="C380b242c-b324-4364-9ea5-7798f2f5e648"> |
− | 	<SearchStatus timestamp="2018-08-28T01:59:38-04:00"/> | + | 		<wcs:CoverageId>Radarsat1--5117806</wcs:CoverageId> |
− | 	<SearchResults numberOfRecordsMatched="1949485" numberOfRecordsReturned="10" | + | 		<metadata xmlns="http://www.opengis.net/gmlcov/1.0" |
− | 		nextRecord="11"> | + | 			xmlns:xlink="http://www.w3.org/1999/xlink" |
− | 		<csw:SummaryRecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" | + | 			xlink:href="https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/ |
− | 			xmlns:ows="http://www.opengis.net/ows" xmlns:dct="http://purl.org/dc/terms/" | + | 			WESSearch/csw/Radarsat1?request=GetRecordById&Id=5117806& |
− | 			xmlns:dc="http://purl.org/dc/elements/1.1/"> | + | 			version=2.0.2&outputSchema=http://schema.compusult.net/services/ |
− | 			<dc:identifier>1511078</dc:identifier> | + | 			2.2.0/WESSearch/csw&service=CSW" xlink:title="CSW GetRecordById" |
− | 			<dc:title>Radarsat-1 Raw Scenes</dc:title> | + | 			xlink:type="simple"/> |
− | 			<dc:type>dataset</dc:type> | + | 		<gml:domainSet> |
− | 			<dc:subject>Satellites, Imaging,Radar, Digital Collection, Mapping, Spatial | + | 			<gml:Polygon gml:id="C06023ce2-944d-478f-a391-4e6736c53f2e" |
− | 				Data, Remote Sensing | + | 				srsDimension="2" srsName="EPSG:4326" |
− | 			</dc:subject> | + | 				xmlns:gml="http://www.opengis.net/gml/3.2"> |
− | 			<dc:subject>F1</dc:subject> | + | 				<gml:exterior> |
− | 			<dc:format>GeoTIFF</dc:format> | + | 					<gml:LinearRing> |
− | 			<dct:abstract>The Radarsat-1 satellite has a synthetic aperture radar(SAR) | + | 						<gml:posList> |
− | 				imaging instrument. The images are used internationally to manage and | + | 							-74.369379 45.510773 |
− | 				monitor the Earth's resources and to monitor global climate change, as | + | 							-81.488928 46.423416 |
− | 				well as in many other commercial and scientific applications. RADARSAT-1 | + | 							-82.487757 41.524618 |
− | 				is ideally suited to supporting these tasks because of its wide range of | + | 							-75.922503 40.612456 |
− | 				beams, SAR technology, frequent revisit period, high-quality products and | + | 							-74.369379 45.510773 |
− | 				fast, efficient delivery. Each of Radarsat-1's seven beam modes offer a | + | 						</gml:posList> |
− | 				different image resolution. The modes include Fine, which covers an area | + | 					</gml:LinearRing> |
− | 				of 50 km × 50 km (31 mi × 31 mi) (2,500 km2 (970 sq mi)) with a resolution | + | 				</gml:exterior> |
− | 				of 10 metres (33 ft); Standard, which covers an area of 100 km × 100 km | + | 			</gml:Polygon> |
− | 				(62 mi × 62 mi) (10,000 km2 (3,900 sq mi)) and has a resolution of 30 metres | + | 		</gml:domainSet> |
− | 				(98 ft); and ScanSAR wide, which covers a 500 km × 500 km (310 mi × 310 mi) | + | 		<rangeType xmlns="http://www.opengis.net/gmlcov/1.0"/> |
− | 				(250,000 km2 (97,000 sq mi)) area with a resolution of 100 metres (330 ft). | + | 		<wcs:ServiceParameters> |
− | 				Radarsat-1 also has the unique ability to direct its beam at different angles. | + | 			<wcs:CoverageSubtype>GridCoverage</wcs:CoverageSubtype> |
− | 			</dct:abstract> | + | 			<wcs:nativeFormat/> |
− | 			<ows:BoundingBox> | + | 			<wcs:Extension> |
− | 				<ows:LowerCorner>32.664853 -3.055419</ows:LowerCorner> | + | 				<DestinationTypes xmlns="http://schema.compusult.net/services/ |
− | 				<ows:UpperCorner>33.172058 -2.442097</ows:UpperCorner> | + | 					2.7.0/WESOrder/wcs"> |
− | 			</ows:BoundingBox></csw:SummaryRecord> | + | 					<Type>Download</Type> |
− | 			... | + | 				</DestinationTypes> |
− | 		</csw:SummaryRecord> | + | 				<Parameter |
− | 	</SearchResults> | + | 					xmlns="http://schema.compusult.net/services/2.7.0/WESOrder"> |
− | </GetRecordsResponse> | + | 					<Name>packagingFormat</Name> |
− | </pre> | + | 					<Title>Packaging Format</Title> |
| + | 					<Description>Packaging Format</Description> |
| + | 					<Default>ZIP</Default> |
| + | 					<Choices> |
| + | 						<Value>ZIP</Value> |
| + | 						<Display>Zip</Display> |
| + | 						<Description>Zip</Description> |
| + | 						<DependentParameters/> |
| + | 					</Choices> |
| + | 					<Choices> |
| + | 						<Value>TAR</Value> |
| + | 						<Display>Tar</Display> |
| + | 						<Description>Tar</Description> |
| + | 						<DependentParameters/> |
| + | 					</Choices> |
| + | 					<Choices> |
| + | 						<Value>TARGZ</Value> |
| + | 						<Display>Tar/GZ</Display> |
| + | 						<Description>Tar/GZ</Description> |
| + | 						<DependentParameters/> |
| + | 					</Choices> |
| + | 					<Choices> |
| + | 						<Value>TAR</Value> |
| + | 						<Display>Tar</Display> |
| + | 						<Description>Tar</Description> |
| + | 						<DependentParameters/> |
| + | 					</Choices> |
| + | 					<Choices> |
| + | 						<Value>TARGZ</Value> |
| + | 						<Display>Tar/GZ</Display> |
| + | 						<Description>Tar/GZ</Description> |
| + | 						<DependentParameters/> |
| + | 					</Choices> |
| + | 				</Parameter> |
| + | 			</wcs:Extension> |
| + | 		</wcs:ServiceParameters> |
| + | 	</wcs:CoverageDescription> |
| + | </wcs:CoverageDescriptions></pre> |
| | | |
− | === CSW GetRecordById === | + | == Github Repo - Web Automation with Katalon == |
| | | |
− | URL (GET REQUEST)
| + | * A [https://github.com/nrcan-eodms-sgdot-rncan/eodms-scene-retriever Katalon utility] to automate website user clicks for searching and ordering. |
− | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog?request=GetRecordById&id=1515826&service=CSW&version=2.0.2</code>
| |
− | | |
− | HTTP RESPONSE
| |
− | <pre>
| |
− | <GetRecordByIdResponse xmlns="http://www.opengis.net/cat/csw/2.0.2">
| |
− | 	<csw:SummaryRecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
| |
− | 		xmlns:ows="http://www.opengis.net/ows" xmlns:dct="http://purl.org/dc/terms/"
| |
− | 		xmlns:dc="http://purl.org/dc/elements/1.1/">
| |
− | 		<dc:identifier>1515826</dc:identifier>
| |
− | 		<dc:title>Radarsat-1 Raw Scenes</dc:title>
| |
− | 		<dc:type>dataset</dc:type>
| |
− | 		<dc:subject>
| |
− | 			Satellites, Imaging,Radar, Digital Collection, Mapping, Spatial Data, Remote Sensing
| |
− | 		</dc:subject>
| |
− | 		<dc:subject>F5</dc:subject>
| |
− | 		<dc:format>GeoTIFF</dc:format>
| |
− | 		<dct:abstract>
| |
− | 			The Radarsat-1 satellite has a synthetic aperture radar(SAR) imaging instrument.
| |
− | 			The images are used internationally to manage and monitor the Earth's resources and
| |
− | 			to monitor global climate change, as well as in many other commercial and scientific
| |
− | 			applications. RADARSAT-1 is ideally suited to supporting these tasks because of its
| |
− | 			wide range of beams, SAR technology, frequent revisit period, high-quality products
| |
− | 			and fast, efficient delivery. Each of Radarsat-1's seven beam modes offer a different
| |
− | 			image resolution. The modes include Fine, which covers an area of 50 km × 50 km
| |
− | 			(31 mi × 31 mi) (2,500 km2 (970 sq mi)) with a resolution of 10 metres (33 ft);
| |
− | 			Standard, which covers an area of 100 km × 100 km (62 mi × 62 mi) (10,000 km2
| |
− | 			(3,900 sq mi)) and has a resolution of 30 metres (98 ft); and ScanSAR wide, which
| |
− | 			covers a 500 km × 500 km (310 mi × 310 mi) (250,000 km2 (97,000 sq mi)) area with a
| |
− | 			resolution of 100 metres (330 ft). Radarsat-1 also has the unique ability to direct
| |
− | 			its beam at different angles.
| |
− | 		</dct:abstract>
| |
− | 		<ows:BoundingBox>
| |
− | 			<ows:LowerCorner>-112.436916 40.41178</ows:LowerCorner>
| |
− | 			<ows:UpperCorner>-111.769493 40.977687</ows:UpperCorner>
| |
− | 		</ows:BoundingBox>
| |
− | 	</csw:SummaryRecord>
| |
− | </GetRecordByIdResponse>
| |
− | </pre>
| |
− | | |
− | == Katalon ==
| |
− | | |
− | Un [https://github.com/nrcan-eodms-sgdot-rncan/eodms-scene-retriever Outil Katalon] pour automatiser les clics de l'utilisateur du site Web pour la recherche et la commande.
| |
− | | |
− | </multilang>
| |