StartDate and CompletionDate in Finder Api v2
CREODIAS users have got a new option to search for images by different time parameters independently. It regards 'startDate and completionDate parameters. All parameters can be used simultaneously.
An additional endpoint has been added to the Finder. The API https://finder.creodias.eu/resto/api2/ works almost the same as https://finder.creodias.eu/resto/api/, except for the following changes:
- parameter startDate is now working as interval
example: https://finder.creodias.eu/resto/api2/collections/Sentinel2/search.json?maxRecords=10&startDate=[2020-08-05T00:00:00Z,2020-09-05T00:00:00Z] - parameter completionDate is now working as interval
example: https://finder.creodias.eu/resto/api2/collections/Sentinel2/search.json?maxRecords=10&completionDate=[2020-08-05T00:00:00Z,2020-09-05T00:00:00Z] - parameter updated is now working as interval
example: https://finder.creodias.eu/resto/api2/collections/Sentinel2/search.json?maxRecords=10&updated=[2020-08-05T00:00:00Z,2020-09-05T00:00:00Z] - parameter published is now working as interval
https://finder.creodias.eu/resto/api2/collections/Sentinel2/search.json?maxRecords=10&published=[2020-08-05T00:00:00Z,2020-09-05T00:00:00Z]
Interval parameters can support one or two values depending on the expected result.
parameter=[value1,value2] - values from value1 inclusive to value2 inclusive
parameter=]value1,value2[ - values from value1 to value2
parameter=[value1,value2[ - values from value1 inclusive to value2
parameter=[value1 - values from value1 inclusive
parameter=]value1 - values from value1
parameter=value2] - values to value2 inclusive
parameter=value2[ - values to value2
All parameters can be used simultaneously and the rest of the API functionalities work as usual. Changes are not implemented in https://finder.creodias.eu/resto/api endpoint.
The limit is 60 requests per minute, per source IP address.
The requests over the limit will be rejected with the code 429.