Line 1: |
Line 1: |
| <multilang>@en| | | <multilang>@en| |
| | | |
− | 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 API Access and 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]
| |
| | | |
| == OpenSearch API (for RADARSAT-1 and NAPL) == | | == OpenSearch API (for RADARSAT-1 and NAPL) == |
Line 14: |
Line 16: |
| To form a get query it would take the form of: | | 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> | + | <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> |
| | | |
| e.g.: | | 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> | + | <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> | | <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> |
Line 63: |
Line 65: |
| URL (POST) | | URL (POST) |
| | | |
− | <code>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_catalog</code> |
| | | |
| HTTP POST - HEADER | | HTTP POST - HEADER |
Line 131: |
Line 133: |
| 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 |
Line 173: |
Line 175: |
| | | |
| === Order that Record / WCS DescribeCoverage === | | === 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) | | URL (GET REQUEST) |
| | | |
− | <code>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> | + | <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) | | URL (POST) |
| | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code> | + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code> |
| | | |
| HTTP POST - HEADER | | HTTP POST - HEADER |
Line 284: |
Line 288: |
| @fr| | | @fr| |
| | | |
− | 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. | + | [[Earth_Observation_Data_Management_System_(EODMS)|SGDOT]] propose plusieurs options pour l’API Access et automation, à savoir Machine 2 Machine. |
| + | |
| + | 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] |
| + | |
| + | 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]] | | [[File:Api-logo.png|link=https://api.canada.ca/en/homepage]] |
| 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) == | | == API OpenSearch (pour RADARSAT-1 et NAPL) == |
| | | |
| Pour former une requête get, cela prendrait la forme suivante: | | 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> | + | <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> |
| | | |
| Par exemple: | | 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> | + | <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>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://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 | | Termes de recherche |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| producttype pouvant être SCN, SGF ou SLC pour Radarsat-1 | | 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. | | sensoroperationalmode qui fait référence à la mnémonique du faisceau comme EH3, F1, W2, SCWB, SCNA, etc. |
Line 316: |
Line 322: |
| 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: | | 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> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| Wildcard Description | | Wildcard Description |
| | | |
Line 323: |
Line 329: |
| </pre> | | </pre> |
| | | |
− | <pre> | + | <pre style="background-color:#EEFFCC; border-color:#AACC99"> |
| Operator Description | | Operator Description |
| | | |
Line 337: |
Line 343: |
| == OGC == | | == OGC == |
| | | |
− | * API compatibles OGC: CSW pour la recherche et WCS pour la commande. Voir [[File:EODMS OGC Services.pdf|none]] pour plus d'informations. | + | * API compatibles OGC: CSW pour la recherche et WCS pour la commande. |
| | | |
− | === CSW GetRecords === | + | === Découvrez des images / CSW GetRecords === |
| | | |
| URL | | URL |
| | | |
− | <code>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_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"><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 361: |
Line 367: |
| 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 403: |
Line 409: |
| </pre> | | </pre> |
| | | |
− | === CSW GetRecordById === | + | === Chercher une seule image / 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 446: |
Line 452: |
| </pre> | | </pre> |
| | | |
− | === WCS DescribeCoverage === | + | === Commandez cette image / WCS DescribeCoverage === |
| + | |
| + | Le message WCS DescribeCoverage est utilisé pour la commande et peut être envoyé sous forme de demande POST ou GET (recommandée). |
| | | |
| URL (GET REQUEST) | | URL (GET REQUEST) |
| | | |
− | <code>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> | + | <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) | | URL (POST) |
| | | |
− | <code>https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code> | + | <code style="background-color:#EEFFCC; border-color:#AACC99">https://www.eodms-sgdot.nrcan-rncan.gc.ca/wes/services/WESOrder/wcs</code> |
| | | |
| HTTP POST - HEADER | | HTTP POST - HEADER |
| | | |
− | <pre><wcs:DescribeCoverage service="WCS" version="2.0.1" | + | <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' | | 	xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' |
| 	xsi:schemaLocation="http://www.opengis.net/wcs/2.0 | | 	xsi:schemaLocation="http://www.opengis.net/wcs/2.0 |
Line 469: |
Line 477: |
| HTTP RESPONSE | | HTTP RESPONSE |
| | | |
− | <pre><wcs:CoverageDescriptions xmlns:wcs="http://www.opengis.net/wcs/2.0"> | + | <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" | | 	<wcs:CoverageDescription xmlns:gml="http://www.opengis.net/gml/3.2" |
| 		gml:id="C380b242c-b324-4364-9ea5-7798f2f5e648"> | | 		gml:id="C380b242c-b324-4364-9ea5-7798f2f5e648"> |