There are no tags associated with this article.

New features of RESTO API

Exact count 

A new parameter “exactCount” allows to get exact count of products returned by a query. It can be enabled in any RESTO API query by adding “&exactCount=1" at the end of a query. This parameter takes only two values: 0 (disabled) or 1 (enabled). By default, this function is disabled for quicker responses and better API performance and the returned count is estimated. For example, to get the exact count of Sentinel-2 L1C products from relative orbit number 50 it is necessary to add to the original query (https://finder.creodias.eu/resto/api/collections/Sentinel2/search.json?maxRecords=10&processingLevel=LEVEL1C&relativeOrbitNumber=50&sortParam=startDate&sortOrder=descending&status=all&dataset=ESA-DATASET) parameter exactCount=1: https://finder.creodias.eu/resto/api/collections/Sentinel2/search.json?maxRecords=10&processingLevel=LEVEL1C&relativeOrbitNumber=50&sortParam=startDate&sortOrder=descending&status=all&dataset=ESA-DATASET&exactCount=1 Please note that processing a query with the exact count parameter takes longer than the same query which count is estimated.  It is not recommended to use this feature if it isn’t needed.  

Relative orbit number as interval 

Relative orbit number now also supports interval values. It is possible to search products from relative orbit numbers from a given range. 

  • relativeOrbitNumber=[50,60] - orbits from 50 inclusive to 60 inclusive 
  • relativeOrbitNumber=]50,60[ - orbits from 50 to 60 
  • relativeOrbitNumber=[50,60[ - orbits from 50 inclusive to 60 
  • relativeOrbitNumber=[50 - orbits from 50 inclusive 
  • relativeOrbitNumber=]50 - orbits from 50 
  • relativeOrbitNumber=60] - orbits to 60 inclusive 
  • relativeOrbitNumber=60[ - orbits to 60 

For example https://finder.creodias.eu/resto/api/collections/Sentinel2/search.json?maxRecords=10&processingLevel=LEVEL1C&relativeOrbitNumber=:50,60:&sortParam=startDate&sortOrder=descending&status=all&dataset=ESA-DATASET 

The feature of searching only one value (relativeOrbitNumber=50) is still supported.