534
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − <multilang>@en|+ − = EODMS APIs (and automation) =+ − + + + − 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]+ − == OpenSearch API (for RADARSAT-1 and NAPL) ==+ − 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+ − To form a get query it would take the form of:+ − <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q={searchterms}</code>+ − e.g.:+ + + + + − <code>https://data.eodms-sgdot.nrcan-rncan.gc.ca/api/dhus/v1/products/Radarsat1/search?q=footprint:Intersects((-130.496,54.672))</code>+ − + − SEARCH TERMS+ − + − 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 − </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: + − <code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code> − == OGC APIs==+ − See [[File:EODMS OGC Services.pdf|none]] for complete details as well as an end-to-end sample.+ − + + + + + + + + + + + − URL+ − <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog?request=GetRecords&service=CSW</code>+ − HTTP POST+ − + + + − HTTP RESPONSE+ − + − <?xml version="1.0" encoding="UTF-8"?> <GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"><SearchStatus timestamp="2018-08-28T01:59:38-04:00"/><SearchResults numberOfRecordsMatched="1949485" numberOfRecordsReturned="10" nextRecord="11">+ − <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>1511078</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>F1</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>32.664853 -3.055419</ows:LowerCorner><ows:UpperCorner>33.172058 -2.442097</ows:UpperCorner></ows:BoundingBox></csw:SummaryRecord> − ... − </SearchResults> − </GetRecordsResponse> − + − − URL − + − HTTP RESPONSE − <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>+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − == Katalon ==+ − * A [https://github.com/nrcan-eodms-sgdot-rncan/eodms-scene-retriever Katalon utility] to automate website user clicks for searching and ordering.+ − @fr|+ − = Les API SGDOT =+ − 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.+ − [[File:Api-logo.png|link=https://api.canada.ca/en/homepage]]+ − 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> − − − − Termes de recherche − − <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:+ − + − + − + − + − + − + − + − + − + − + − Ainsi, comme indiqué précédemment, il est fortement calqué sur les concentrateurs de données ESA: + − + + + + + + + + + + + + + − * 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?request=GetRecords&service=CSW</code>+ − HTTP POST+ + + + + + + + + + + − <pre><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>+ + + + + + + + + + + + + + + − + − + − + − + − + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + + + + + + + + + + + + + + + + + − + + + + + + + − 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.+ − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
no edit summary
== Overview ==
[[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.
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.
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
=== 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>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>
<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>
<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>
</pre>
BOOLEAN
<pre>
<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>
<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:
=== CSW GetRecords ===
<pre style="background-color:#EEFFCC; border-color:#AACC99">
{
"destinations": [],
"items": [
{
"collectionId": "RCMImageProducts",
"recordId": "7189214"
}
]
}
</pre>
== OPENSEARCH API ==
=== OPENSEARCH Search ===
BASIC
<pre><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>
<pre style="background-color:#EEFFCC; border-color:#AACC99">
https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/rapi/opensearch/search?q=*
</pre>
SPATIAL
<pre>
<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>
</pre>
=== CSW GetRecordById ===
=== OPENSEARCH Order ===
<code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/MetaManagerCSW/csw/eodms_catalog?request=GetRecordById&id=1515826&service=CSW&version=2.0.2</code>
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>
<pre>
<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>
</pre>
== OPENSEARCH API. Copernicus Hub Inspired. Provides Direct Download. RADARSAT-1 and NAPL, ONLY) ==
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.
QUERY FORMAT
<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>
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
<pre style="background-color:#EEFFCC; border-color:#AACC99">
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
<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>
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
ingestiondate
beginposition
beginposition
endposition
endposition
footprint (point et polygon)
footprint (point and polygon)
</pre>
</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>
<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>
Heavily modeled after the ESA Data hubs so the following should apply:
<code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code>
<code>https://colhub.copernicus.eu/userguide/OpenSearchAPI</code>
== OGC ==
== OGC APIs ==
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]
=== Discover some data / CSW GetRecords ===
URL (POST)
Each data collection has a separate URL. The following are supported:
<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>
<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>
</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"?> <GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2"><SearchStatus timestamp="2018-08-28T01:59:38-04:00"/><SearchResults numberOfRecordsMatched="1949485" numberOfRecordsReturned="10" nextRecord="11">
<?xml version="1.0" encoding="UTF-8"?>
<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>1511078</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>F1</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
<GetRecordsResponse xmlns="http://www.opengis.net/cat/csw/2.0.2">
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>32.664853 -3.055419</ows:LowerCorner><ows:UpperCorner>33.172058 -2.442097</ows:UpperCorner></ows:BoundingBox></csw:SummaryRecord>
	<SearchStatus timestamp="2018-08-28T01:59:38-04:00"/>
...
	<SearchResults numberOfRecordsMatched="1949485" numberOfRecordsReturned="10"
</SearchResults>
		nextRecord="11">
		<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>1511078</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>F1</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>32.664853 -3.055419</ows:LowerCorner>
				<ows:UpperCorner>33.172058 -2.442097</ows:UpperCorner>
			</ows:BoundingBox>
		</csw:SummaryRecord>
		...
	</SearchResults>
</GetRecordsResponse>
</GetRecordsResponse>
</pre>
</pre>
=== CSW GetRecordById ===
=== Fetch a Single Record / CSW GetRecordById ===
URL
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" xmlns:ows="http://www.opengis.net/ows" xmlns:dct="http://purl.org/dc/terms/" xmlns:dc="http://purl.org/dc/elements/1.1/">
	<csw:SummaryRecord xmlns:csw="http://www.opengis.net/cat/csw/2.0.2"
<dc:identifier>1515826</dc:identifier>
		xmlns:ows="http://www.opengis.net/ows"
<dc:title>Radarsat-1 Raw Scenes</dc:title>
		xmlns:dct="http://purl.org/dc/terms/"
<dc:type>dataset</dc:type>
		xmlns:dc="http://purl.org/dc/elements/1.1/">
<dc:subject>
		<dc:identifier>1515826</dc:identifier>
Satellites, Imaging,Radar, Digital Collection, Mapping, Spatial Data, Remote Sensing
		<dc:title>Radarsat-1 Raw Scenes</dc:title>
</dc:subject>
		<dc:type>dataset</dc:type>
<dc:subject>F5</dc:subject>
		<dc:subject>Satellites, Imaging,Radar, Digital Collection, Mapping,
<dc:format>GeoTIFF</dc:format>
			Spatial Data, Remote Sensing
<dct:abstract>
		</dc:subject>
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.
		<dc:subject>F5</dc:subject>
</dct:abstract>
		<dc:format>GeoTIFF</dc:format>
<ows:BoundingBox>
		<dct:abstract>The Radarsat-1 satellite has a synthetic aperture radar(SAR)
<ows:LowerCorner>-112.436916 40.41178</ows:LowerCorner>
			imaging instrument. The images are used internationally to manage and
<ows:UpperCorner>-111.769493 40.977687</ows:UpperCorner>
			monitor the Earth's resources and to monitor global climate change,
</ows:BoundingBox>
			as well as in many other commercial and scientific applications.
</csw:SummaryRecord>
			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>
</GetRecordByIdResponse>
</pre>
</pre>
== Katalon ==
=== Order that Record / WCS DescribeCoverage ===
The WCS DescribeCoverage message is used for ordering and can be sent as a POST or GET (recommended) request.
URL (GET REQUEST)
<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>
URL (POST)
</multilang>
<code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code>
HTTP POST - HEADER
<pre style="background-color:#EEFFCC; border-color:#AACC99"><wcs:DescribeCoverage service="WCS" version="2.0.1"
	xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
	xsi:schemaLocation="http://www.opengis.net/wcs/2.0
	http://schemas.opengis.net/wcs/2.0/wcsAll.xsd"
	xmlns="http://www.opengis.net/wcs/2.0"
	xmlns:wcs="http://www.opengis.net/wcs/2.0">
	<wcs:CoverageId>Radarsat1--5117806</wcs:CoverageId>
</wcs:DescribeCoverage></pre>
HTTP RESPONSE
<pre style="background-color:#EEFFCC; border-color:#AACC99"><wcs:CoverageDescriptions xmlns:wcs="http://www.opengis.net/wcs/2.0">
	<wcs:CoverageDescription xmlns:gml="http://www.opengis.net/gml/3.2"
		gml:id="C380b242c-b324-4364-9ea5-7798f2f5e648">
		<wcs:CoverageId>Radarsat1--5117806</wcs:CoverageId>
		<metadata xmlns="http://www.opengis.net/gmlcov/1.0"
			xmlns:xlink="http://www.w3.org/1999/xlink"
			xlink:href="https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/
			WESSearch/csw/Radarsat1?request=GetRecordById&Id=5117806&
			version=2.0.2&outputSchema=http://schema.compusult.net/services/
			2.2.0/WESSearch/csw&service=CSW" xlink:title="CSW GetRecordById"
			xlink:type="simple"/>
		<gml:domainSet>
			<gml:Polygon gml:id="C06023ce2-944d-478f-a391-4e6736c53f2e"
				srsDimension="2" srsName="EPSG:4326"
				xmlns:gml="http://www.opengis.net/gml/3.2">
				<gml:exterior>
					<gml:LinearRing>
						<gml:posList>
							-74.369379 45.510773
							-81.488928 46.423416
							-82.487757 41.524618
							-75.922503 40.612456
							-74.369379 45.510773
						</gml:posList>
					</gml:LinearRing>
				</gml:exterior>
			</gml:Polygon>
		</gml:domainSet>
		<rangeType xmlns="http://www.opengis.net/gmlcov/1.0"/>
		<wcs:ServiceParameters>
			<wcs:CoverageSubtype>GridCoverage</wcs:CoverageSubtype>
			<wcs:nativeFormat/>
			<wcs:Extension>
				<DestinationTypes xmlns="http://schema.compusult.net/services/
					2.7.0/WESOrder/wcs">
					<Type>Download</Type>
				</DestinationTypes>
				<Parameter
					xmlns="http://schema.compusult.net/services/2.7.0/WESOrder">
					<Name>packagingFormat</Name>
					<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>
== Github Repo - Web Automation with Katalon ==
* A [https://github.com/nrcan-eodms-sgdot-rncan/eodms-scene-retriever Katalon utility] to automate website user clicks for searching and ordering.
