OpenSearch Description Document
In OpenSearch, you can get description of a first level of information called Step 1, which is at the top level of the available collections. Then from the result of the Step 1, you can get detailed information of a collection which called Step 2. The two next sections present these steps 1 & 2. It is worth noting that, the OpenSearch Description Document (OSDD)can change according to new collectionsimplemented in ONDA catalogue, and values presented hereunder, can be modified accordingly. You should request the OSDD (Step 1 & 2) regularly to check and update your application according to ONDA catalogue updates.
OpenSearch Description – Step1
Objective: Get description of available collections and possible values of parameters
Protocol: OpenSearch
Request:
https://catalogue.onda-dias.eu/opensearch/OpenSearchDescription |
Response:
This XML file does not appear to have any style information associated with it. The document tree is shown below. </LongName> |
Use of the OpenSearch filters – Step 2
OpenSearch filters
SearchTerm can contains wildcards like ? or * and can be mixed with other logical operators like AND, OR and NOT.
e.g: Get product by platformShortName and instrumentShortName
https://catalogue.ondadias.eu/opensearch/OpenSearch?searchTerms=platformShortName:S2%20AND%20instrumentShortName:MSI |
Search a product by its identifier
Objective: Retrieve metadata for one product according to its product identifier
Protocol: OpenSearch
Request:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=id:fc63ba03-2315-419f-832c-591d1df30e7c |
Response:
<feed xmlns=”http://www.w3.org/2005/Atom” xmlns:os=”http://a9.com/-/spec/opensearch/1.1/” xmlns:dif=”http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/” xmlns:dc=”http://purl.org/dc/elements/1.1/” xmlns:inspire=”http://onda-dias.eu/ns/opensearch/1.1/” xmlns:inspire_dls=”http://inspire.ec.europa.eu/schemas/inspire_dls/1.0″ xmlns:inspire_common=”http://inspire.ec.europa.eu/schemas/common/1.0″ xmlns:time=”http://a9.com/-/opensearch/extensions/time/1.0/” xmlns:geo=”http://a9.com/-/opensearch/extensions/geo/1.0/” xmlns:ONDA=”http://onda-dias.eu/ns/ONDA” xmlns:georss=”http://www.georss.org/georss” xmlns:atom=”http://www.w3.org/2005/Atom” xmlns:eo=”http://a9.com/-/opensearch/extensions/eo/1.0/” xmlns:gmd=”http://www.isotc211.org/2005/gmd” xmlns:gmi=”http://www.isotc211.org/2005/gmi” xmlns:gml=”http://www.opengis.net/gml/3.2″ xmlns:semantic=”http://a9.com/-/opensearch/extensions/semantic/1.0/” xmlns:sru=”http://a9.com/-/opensearch/extensions/sru/2.0/” xmlns:urlencoder=”java.net.URLEncoder”> <title>ONDA / INSPIRE Dataset Search Results</title> <updated>2019-06-25T11:04:09.120+02:00</updated> <author> <name>onda-dias.eu</name> <email>support@onda-dias.eu</email> <uri>http://onda-dias.eu</uri> </author> <link href=”http://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=id:fc63ba03-2315-419f-832c-591d1df30e7c” rel=”self” hreflang=”eng” type=”application/atom+xml”/> <id> http://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=id:fc63ba03-2315-419f-832c-591d1df30e7c </id> <rights>Copyright (c), ONDA DIAS; all rights reserved</rights> <link href=”http://inspire.ec.europa.eu/featureconcept/EnvironmentalMonitoringProgramme” rel=”describedby” type=”text/html”/> <link href=”http://catalogue.onda-dias.eu/opensearch/OpenSearch?” rel=”describedby” type=”application/xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/OpenSearchDescription” rel=”self” type=”application/opensearchdescription+xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=id:fc63ba03-2315-419f-832c-591d1df30e7c&startIndex=1″ rel=”first”/> <os:totalResults>1</os:totalResults> <os:startIndex>1</os:startIndex> <os:itemsPerPage>25</os:itemsPerPage> <os:query role=”request” inspire:source=”INSPIRE” maxRecords=”25″ startIndex=”1″ searchTerms=”id:fc63ba03-2315-419f-832c-591d1df30e7c”/> <entry> <title> S2B_MSIL1C_20181218T075329_N0207_R135_T36KTU_20181218T094806.SAFE </title> <link href=”http://catalogue.onda-dias.eu/opensearch/id/fc63ba03-2315-419f-832c-591d1df30e7c” rel=”alternate” type=”application/x-shapefile” lenght=”756507440.0″/> <link href=”http://catalogue.onda-dias.eu/opensearch/id/fc63ba03-2315-419f-832c-591d1df30e7c” rel=”alternate” type=”application/atom+xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/id/fc63ba03-2315-419f-832c-591d1df30e7c” rel=”describedBy” type=”text/html”/> <link href=”http://catalogue.onda-dias.eu/opensearch/id/fc63ba03-2315-419f-832c-591d1df30e7c” rel=”describedBy” type=”application/atom+xml”/> <category label=”ONDA DIAS” term=”ONDA DIAS”/> <id>fc63ba03-2315-419f-832c-591d1df30e7c</id> <inspire_common:datasetVersion/> <updated>2019-06-25T11:04:09.120+02:00</updated> <creationDate>2019-06-21T06:31:25Z</creationDate> <inspire_common:datasetId>fc63ba03-2315-419f-832c-591d1df30e7c</inspire_common:datasetId> <inspire_common:dataCenter>[]</inspire_common:dataCenter> <ONDA:dateOfCreation>2018-12-18T09:48:06Z</ONDA:dateOfCreation> <ONDA:tileIdentifier>36KTU</ONDA:tileIdentifier> <ONDA:_text_> [“36KTU”, “S2”, “PASSED”, “MSI”, “PASSED”, “SAFE”, “DESCENDING”, “GS2B_20181218T075329_009313_N02.07”, “PASSED”, “S2B_MSIL1C_20181218T075329_N0207_R135_T36KTU_20181218T094806.zip”, “S2MSI1C”, “PASSED”, “Multi-Spectral Instrument”, “PASSED”, “2017-013A”, “OPTICAL”, “S2B_MSIL1C_20181218T075329_N0207_R135_T36KTU_20181218T094806.SAFE”, “Sentinel-2”, “KU36T”, “INS-NOBS”, “2B”, “LEVEL-1C”] </ONDA:_text_> <ONDA:temporalExtentBeginPosition>2018-12-18T07:53:29.024Z</ONDA:temporalExtentBeginPosition> <ONDA:platformShortName>S2</ONDA:platformShortName> <ONDA:specificationDate>2013-10-29</ONDA:specificationDate> <eo:processingDate>2018-12-18T09:48:06Z</eo:processingDate> <ONDA:geographicBoundingBoxWestBoundLongitude>30.04022707498483</ONDA:geographicBoundingBoxWestBoundLongitude> <ONDA:sensorQualityFlag>PASSED</ONDA:sensorQualityFlag> <ONDA:resourceTitle>Sentinel-2 Level-1C (short name: L1C)</ONDA:resourceTitle> <ONDA:topicCategory>imageryBaseMapsEarthCover</ONDA:topicCategory> <ONDA:specificationDateType>revision</ONDA:specificationDateType> <ONDA:resourceLocator> https://catalogue.onda-dias.eu/dias-catalogue/Products(fc63ba03-2315-419f-832c-591d1df30e7c)/$value </ONDA:resourceLocator> <eo:instrumentShortName>MSI</eo:instrumentShortName> <ONDA:resourceLanguage>eng</ONDA:resourceLanguage> <ONDA:geographicBoundingBoxNorthBoundLatitude>-23.482318605171184</ONDA:geographicBoundingBoxNorthBoundLatitude> <ONDA:nodeId>863f8998-8809-36e8-8c31-b1caf53d98f0</ONDA:nodeId> <ONDA:dataTakeSensingStart>2018-12-18T07:53:29.024Z</ONDA:dataTakeSensingStart> <ONDA:geometricQualityFlag>PASSED</ONDA:geometricQualityFlag> <ONDA:temporalExtentEndPosition>2018-12-18T07:53:29.024Z</ONDA:temporalExtentEndPosition> <ONDA:pseudoPath> [“OPTICAL/LEVEL-1C/2018/12/18”, “S2/2B/MSI/LEVEL-1C/S2MSI1C/2018/12/18”, “S2/2B/LEVEL-1C/S2MSI1C/2018/12/18”, “S2/MSI/LEVEL-1C/S2MSI1C/2018/12/18”, “S2/LEVEL-1C/S2MSI1C/2018/12/18”, “2017-013A/MSI/LEVEL-1C/S2MSI1C/2018/12/18”, “2017-013A/LEVEL-1C/S2MSI1C/2018/12/18”] </ONDA:pseudoPath> <ONDA:format>SAFE</ONDA:format> <ONDA:metadataPointOfContactEmail>support@onda-dias.eu</ONDA:metadataPointOfContactEmail> <ONDA:keywordValue> opticalEarthObservation Satellite Sentinel-2 S2 MSI L1C </ONDA:keywordValue> <eo:orbitDirection>DESCENDING</eo:orbitDirection> <ONDA:responsiblePartyEmail>support@onda-dias.eu</ONDA:responsiblePartyEmail> <ONDA:dataTakeIdentifier>GS2B_20181218T075329_009313_N02.07</ONDA:dataTakeIdentifier> <ONDA:formatCorrectnessFlag>PASSED</ONDA:formatCorrectnessFlag> <ONDA:metadataLanguage>eng</ONDA:metadataLanguage> <ONDA:geographicBoundingBoxSouthBoundLatitude>-24.485936576309438</ONDA:geographicBoundingBoxSouthBoundLatitude> <ONDA:creationDate>2019-06-21T06:31:25Z</ONDA:creationDate> <ONDA:lineage>Not evaluated</ONDA:lineage> <ONDA:beginPosition>2018-12-18T07:53:29.024Z</ONDA:beginPosition> <ONDA:name> S2B_MSIL1C_20181218T075329_N0207_R135_T36KTU_20181218T094806.zip </ONDA:name> <ONDA:responsiblePartyOrganisationName>ONDA DIAS</ONDA:responsiblePartyOrganisationName> <ONDA:resourceType>dataset</ONDA:resourceType> <ONDA:conditionsApplyingToAccessAndUse>No conditions apply</ONDA:conditionsApplyingToAccessAndUse> <ONDA:geographicBoundingBoxEastBoundLongitude>31.100024442559125</ONDA:geographicBoundingBoxEastBoundLongitude> <eo:productType>S2MSI1C</eo:productType> <ONDA:radiometricQualityFlag>PASSED</ONDA:radiometricQualityFlag> <ONDA:processingBaseline>2.07</ONDA:processingBaseline> <eo:instrumentName>Multi-Spectral Instrument</eo:instrumentName> <ONDA:specificationTitle> INSPIRE Metadata Implementing Rules: Technical Guidelines based on EN ISO 19115 and EN ISO 19119 V 1.3 </ONDA:specificationTitle> <ONDA:endPosition>2018-12-18T07:53:29.024Z</ONDA:endPosition> <ONDA:relativeOrbitNumber>135</ONDA:relativeOrbitNumber> <ONDA:generalQualityFlag>PASSED</ONDA:generalQualityFlag> <ONDA:degradedMSIDataPercentage>0.0</ONDA:degradedMSIDataPercentage> <ONDA:id>fc63ba03-2315-419f-832c-591d1df30e7c</ONDA:id> <ONDA:platformNssdcid>2017-013A</ONDA:platformNssdcid> <ONDA:sensorType>OPTICAL</ONDA:sensorType> <ONDA:storage>GAEL_REF_SANITY_S2B_201812</ONDA:storage> <ONDA:filename> S2B_MSIL1C_20181218T075329_N0207_R135_T36KTU_20181218T094806.SAFE </ONDA:filename> <ONDA:resourceTitleDatasetSeries>Sentinel-2 Level-1C</ONDA:resourceTitleDatasetSeries> <ONDA:offline>false</ONDA:offline> <ONDA:size>756507440.0</ONDA:size> <ONDA:platformName>Sentinel-2</ONDA:platformName> <ONDA:resourceAbstract> The Level-1C product is composed of 100×100 km2 tiles (ortho-images in UTM/WGS84 projection). The Level-1C product results from using a Digital Elevation Model (DEM) to project the image in cartographic geometry. Per-pixel radiometric measurements are provided in Top Of Atmosphere (TOA) reflectances along with the parameters to transform them into radiances. Level-1C products are resampled with a constant Ground Sampling Distance (GSD) of 10, 20 and 60 m depending on the native resolution of the different spectral bands. In Level-1C products, pixel coordinates refer to the upper left corner of the pixel. Level-1C products will additionally include Cloud Masks and ECMWF data (total column of ozone, total column of water vapour and mean sea level pressure) </ONDA:resourceAbstract> <ONDA:responsiblePartyRole>distributor</ONDA:responsiblePartyRole> <ONDA:degradedAncillaryDataPercentage>0.0</ONDA:degradedAncillaryDataPercentage> <ONDA:degree>Not evaluated</ONDA:degree> <ONDA:metadataPointOfContactOrganisationName>ONDA DIAS</ONDA:metadataPointOfContactOrganisationName> <ONDA:orderedTileIdentifier>KU36T</ONDA:orderedTileIdentifier> <ONDA:footprint> MULTIPOLYGON (((30.8635998474937 -24.4859365763094,30.8787076115528 -24.4264404250009,30.9141691730348 -24.2785989880554,30.9496326385742 -24.1306848989062,30.9849432910881 -23.9826597406598,31.0199482978143 -23.8345246727276,31.0553771211483 -23.6865026211188,31.0905473592657 -23.5384023596742,31.1000244425591 -23.4983016503366,30.0627896482774 -23.4823186051712,30.0402270749848 -24.4727476124369,30.8635998474937 -24.4859365763094))) </ONDA:footprint> <ONDA:limitationsOnPublicAccessClassification>unclassified</ONDA:limitationsOnPublicAccessClassification> <ONDA:sensorOperationalMode>INS-NOBS</ONDA:sensorOperationalMode> <ONDA:platformSerialIdentifier>2B</ONDA:platformSerialIdentifier> <eo:processingLevel>LEVEL-1C</eo:processingLevel> <ONDA:cloudCoverPercentage>0.1057</ONDA:cloudCoverPercentage> <inspire_dls:spatial_dataset_identifier_code>s2:l1c:fc63ba03-2315-419f-832c-591d1df30e7c</inspire_dls:spatial_dataset_identifier_code> <inspire_dls:spatial_dataset_identifier_namespace>urn:esa:dias:onda</inspire_dls:spatial_dataset_identifier_namespace> <ONDA:orbitNumber>9313</ONDA:orbitNumber> <ONDA:limitationsOnPublicAccessOtherConstraints>No limitations</ONDA:limitationsOnPublicAccessOtherConstraints> <ONDA:_version_>1636930616032231424</ONDA:_version_> </entry> </feed> |
Sample OpenSearch requests
Get Products by orbitDirection and platformName:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?orbitDirection=DESCENDING&platformName=Sentinel-3 |
Count Products:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?count |
Other examples:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=platformName%3ASentinel-2+productType%3AS2MSI1C |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=id:fc63ba03-2315-419f-832c-591d1df30e7c |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=-id:16832005-e373-412b-a602-ba08e07b0953 |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?degree=%22Not%20evaluated%22&language=eng |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=platformName%3ASentinel-2+productType%3AS2MSI1C&sortKeys=asc |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=-resourceType:dataset |
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=topicCategory:imageryBaseMapsEarthCover |
How to get number of records for a requested
Like any other OpenSearch request, it is possible to set the request to return only the number records corresponding to the request. Set the value of the count parameter to 0 (zero) in your request like hereunder:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?count=0 |
Result:
<feed xmlns=”http://www.w3.org/2005/Atom” xmlns:os=”http://a9.com/-/spec/opensearch/1.1/” xmlns:dif=”http://gcmd.gsfc.nasa.gov/Aboutus/xml/dif/” xmlns:dc=”http://purl.org/dc/elements/1.1/” xmlns:inspire=”http://onda-dias.eu/ns/opensearch/1.1/” xmlns:inspire_dls=”http://inspire.ec.europa.eu/schemas/inspire_dls/1.0″ xmlns:inspire_common=”http://inspire.ec.europa.eu/schemas/common/1.0″ xmlns:time=”http://a9.com/-/opensearch/extensions/time/1.0/” xmlns:geo=”http://a9.com/-/opensearch/extensions/geo/1.0/” xmlns:ONDA=”http://onda-dias.eu/ns/ONDA” xmlns:georss=”http://www.georss.org/georss” xmlns:atom=”http://www.w3.org/2005/Atom” xmlns:eo=”http://a9.com/-/opensearch/extensions/eo/1.0/” xmlns:gmd=”http://www.isotc211.org/2005/gmd” xmlns:gmi=”http://www.isotc211.org/2005/gmi” xmlns:gml=”http://www.opengis.net/gml/3.2″ xmlns:semantic=”http://a9.com/-/opensearch/extensions/semantic/1.0/” xmlns:sru=”http://a9.com/-/opensearch/extensions/sru/2.0/” xmlns:urlencoder=”java.net.URLEncoder”> <title>ONDA / INSPIRE Dataset Search Results</title> <updated>2019-06-25T11:15:37.346+02:00</updated> <author> <name>onda-dias.eu</name> <email>support@onda-dias.eu</email> <uri>http://onda-dias.eu</uri> </author> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?count=0″ rel=”self” hreflang=”eng” type=”application/atom+xml”/> <id> http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?count=0 </id> <rights>Copyright (c), ONDA DIAS; all rights reserved</rights> <link href=”http://inspire.ec.europa.eu/featureconcept/EnvironmentalMonitoringProgramme” rel=”describedby” type=”text/html”/> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?” rel=”describedby” type=”application/xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearchDescription” rel=”self” type=”application/opensearchdescription+xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?count=0&startIndex=1″ rel=”first”/> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?count=0&startIndex=1″ rel=”next”/> <link href=”http://catalogue.onda-dias.eu/opensearch/api/inspire/2/OpenSearch?count=0&startIndex=1″ rel=”previous”/> <os:totalResults>113</os:totalResults> <os:startIndex>1</os:startIndex> <os:itemsPerPage>0</os:itemsPerPage> <os:query role=”request” inspire:source=”INSPIRE” maxRecords=”0″ startIndex=”1″/> </feed> |