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 collections implemented 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 – Step 1
Objective: Get description of available collections and possible values of parameters
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. |
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 OR.
Examples:
e.g: Get product by platformShortName and instrumentShortName
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=platformShortName:S2%20AND%20instrumentShortName:MSI |
Search Sentinel-1A or Sentinel-2A products
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=name:S1A*%20OR%20S2A* |
[alternatively]
https://catalogue.onda-dias.eu/opensearch//OpenSearch?searchTerms=name:S1A*%20OR%20name:S2A* |
Search a product by its identifier
Objective: Retrieve metadata for one product according to its product identifier
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> |
Sorting results
The list of results can be sorted using “sortKeys” and can be arranged in descending order (desc) or ascending order (asc).
Example:
Search products where platformName=Sentinel-2 and productType=S2MSI1 with creationDate arranged in descending order
https://catalogue.onda-dias.eu/opensearch/OpenSearch?platformName=Sentinel-2&productType=S2MSI1C&sortKeys=creationDate%2C%2Cdesc |
Paging results
A query can be completed with the pagination options, using startIndex and count.
Please note that the default number of records returned in a single query is set to 25.
Search products with creationDate in a specific time range (from record 1 to 25, by default):
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[2021-02-22T00:00:01Z%20TO%202021-02-22T01:00:01Z] |
Search products with creationDate in a specific time range (from record 2 to 26, using startIndex):
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[2021-02-22T00:00:01Z%20TO%202021-02-22T01:00:01Z]&startIndex=2 |
Search products with creationDate in a specific time range (the first 5 records, starting from record 2)
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[2021-02-22T00:00:01Z%20TO%202021-02-22T01:00:01Z ]&startIndex=2&count=5 |
Search products with creationDate in a specific time range (100 records):
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[2021-02-22T00:00:01Z%20TO%202021-02-22T01:00:01Z ]&count=100 |
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:
Request:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?count=0 |
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: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/opensearch/OpenSearch?count=0″ rel=”self” hreflang=”eng” type=”application/atom+xml”/> <id> http://catalogue.onda-dias.eu/opensearch/opensearch/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/opensearch/OpenSearch?” rel=”describedby” type=”application/xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/opensearch/OpenSearchDescription” rel=”self” type=”application/opensearchdescription+xml”/> <link href=”http://catalogue.onda-dias.eu/opensearch/opensearch/OpenSearch?count=0&startIndex=1″ rel=”first”/> <link href=”http://catalogue.onda-dias.eu/opensearch/opensearch/OpenSearch?count=0&startIndex=1″ rel=”next”/> <link href=”http://catalogue.onda-dias.eu/opensearch/opensearch/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> |
Sample OpenSearch requests
Count products:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?count |
Search S2 MSIL1C products:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=platformName:Sentinel-2%20AND%20productType:S2MSI1C |
Search products with id different (not equal) to the selected one
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=-id:16832005-e373-412b-a602-ba08e07b0953 |
Get products by orbitDirection and platformName:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?orbitDirection=DESCENDING&platformName=Sentinel-3 |
Search products with creationDate in the last day in descending order
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[NOW%2D1DAY%20TO%20NOW]&sortKeys=creationDate%2C%2Cdesc |
Search products with creationDate in the last day in ascending order
https://catalogue.onda-dias.eu/opensearch/OpenSearch?creationDate=[NOW%2D30DAYS%20TO%20NOW]&sortKeys=creationDate%2C%2Casc |
Search S3 Eumetsat products (100 records):
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=productType:OL_2_WFR___%20OR%20OL_2_WRR___%20OR%20SL_2_WST___%20OR%20SR_2_WAT___&count=100 |
Search Sentinel-3 Land products (100 records):
Search products where resourceType metadatum not equal to “dataset”:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=-resourceType:dataset |
Search products where topicCategory is imageryBaseMapsEarthCover:
https://catalogue.onda-dias.eu/opensearch/OpenSearch?searchTerms=topicCategory:imageryBaseMapsEarthCover |
Search products where degree=”Not evaluated” and language is eng (for english), with two different parameters (one for metadata in ‘searchTerms’, and second one for the api ‘language’)
https://catalogue.onda-dias.eu/opensearch/OpenSearch?degree=%22Not%20evaluated%22&language=eng |