|
|
| (22 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | <multilang>@en|
| |
| | | | |
| − | == 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.
| |
| − |
| |
| − | 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]]
| |
| − | https://api.canada.ca/en/homepage
| |
| − |
| |
| − | == REST API (Search) ==
| |
| − | Default result format is human-readable HTML. Appending <pre>&format=json'</pre> or <pre>'=xml'</pre> 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 (timestamp e.g. 2000 - 2005)
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | CATALOG_IMAGE.PUBLIC_GOOD (boolean e.g. CATALOG_IMAGE.PUBLIC_GOOD)
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | NAPL ROLL / PHOTO (string e.g. A128_0032)
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | == 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 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.:
| |
| − |
| |
| − | <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
| |
| − | 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 style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | Wildcard Description
| |
| − |
| |
| − | * any sequence of zero or more characters
| |
| − | ? any one character
| |
| − | </pre>
| |
| − |
| |
| − | <pre style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | 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==
| |
| − |
| |
| − | 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
| |
| − |
| |
| − | <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">
| |
| − | 		<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>
| |
| − | </pre>
| |
| − |
| |
| − | === Fetch a Single Record / CSW GetRecordById ===
| |
| − |
| |
| − | URL (GET REQUEST)
| |
| − |
| |
| − | <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
| |
| − | <pre style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | <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>
| |
| − |
| |
| − | === 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)
| |
| − |
| |
| − | <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 - End-to-End OGC Order Example with Python ===
| |
| − |
| |
| − | Checkout out our [https://github.com/nrcan-eodms-sgdot-rncan/eodms-ogc-client-py/wiki open source Python module on GitHub] use the CSW and WCS APIs to order images from EODMS.
| |
| − |
| |
| − | == 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.
| |
| − |
| |
| − | @fr|
| |
| − | == Aperçu ==
| |
| − |
| |
| − | [[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]]
| |
| − | https://api.canada.ca/en/homepage
| |
| − |
| |
| − | == API OpenSearch (pour RADARSAT-1 et NAPL) ==
| |
| − |
| |
| − | Pour former une requête get, cela prendrait la forme suivante:
| |
| − | <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:
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | Termes de recherche
| |
| − |
| |
| − | <pre style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | 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 style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | Wildcard Description
| |
| − |
| |
| − | * any sequence of zero or more characters
| |
| − | ? any one character
| |
| − | </pre>
| |
| − |
| |
| − | <pre style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | 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 ==
| |
| − |
| |
| − | Voici des exemples d'utilisation des API OGC de SGDOT avec un complet [https://github.com/nrcan-eodms-sgdot-rncan/eodms-ogc-client-py/wiki module Python open source sur GitHub]
| |
| − |
| |
| − | === Découvrez des images / CSW GetRecords ===
| |
| − |
| |
| − | URL
| |
| − |
| |
| − | Chaque collecte de données a une URL distincte. Les éléments suivants sont pris en charge:
| |
| − |
| |
| − | <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:Constraint version='1.1.0'>
| |
| − | <ogc:Filter>
| |
| − | <ogc:BBOX>
| |
| − | <ogc:PropertyName>ows:BoundingBox</ogc:PropertyName>
| |
| − | <gml:Envelope>
| |
| − | <gml:lowerCorner>-53.0 47.2</gml:lowerCorner>
| |
| − | <gml:upperCorner>-52.5 47.8</gml:upperCorner>
| |
| − | </gml:Envelope>
| |
| − | </ogc:BBOX>
| |
| − | </ogc:Filter>
| |
| − | </csw:Constraint>
| |
| − | </csw:Query>
| |
| − | </csw:GetRecords>
| |
| − | </pre>
| |
| − |
| |
| − | HTTP POST - HEADER (Avec enveloppe SOAP nom d'utilisateur / mot de passe)
| |
| − |
| |
| − | <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:Constraint version='1.1.0'>
| |
| − | <ogc:Filter>
| |
| − | <ogc:BBOX>
| |
| − | <ogc:PropertyName>ows:BoundingBox</ogc:PropertyName>
| |
| − | <gml:Envelope>
| |
| − | <gml:lowerCorner>-53.0 47.2</gml:lowerCorner>
| |
| − | <gml:upperCorner>-52.5 47.8</gml:upperCorner>
| |
| − | </gml:Envelope>
| |
| − | </ogc:BBOX>
| |
| − | </ogc:Filter>
| |
| − | </csw:Constraint>
| |
| − | </csw:Query>
| |
| − | </csw:GetRecords>
| |
| − |
| |
| − | </soapenv:Body>
| |
| − | </soapenv:Envelope>
| |
| − | </pre>
| |
| − |
| |
| − | HTTP RESPONSE
| |
| − |
| |
| − | <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">
| |
| − | 		<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>
| |
| − | 			...
| |
| − | 		</csw:SummaryRecord>
| |
| − | 	</SearchResults>
| |
| − | </GetRecordsResponse>
| |
| − | </pre>
| |
| − |
| |
| − | === Chercher une seule image / CSW GetRecordById ===
| |
| − |
| |
| − | URL (GET REQUEST)
| |
| − |
| |
| − | <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
| |
| − | <pre style="background-color:#EEFFCC; border-color:#AACC99">
| |
| − | <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>
| |
| − |
| |
| − | === 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)
| |
| − |
| |
| − | <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)
| |
| − |
| |
| − | <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>
| |
| − |
| |
| − | === Exemple de commande de bout en bout (avec Python) ===
| |
| − |
| |
| − | Découvrez notre [https://github.com/nrcan-eodms-sgdot-rncan/eodms-ogc-client-py/wiki module Python Open Source sur GitHub] pour rechercher les services CSW et WCS afin de commander des images de l'EODMS.
| |
| − |
| |
| − | == Automatisation web avec 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>
| |
