Home > Develop > Community > OpenSearch Interface

OpenSearch Interface

OpenSearch Interface

OpenSearch interface provides easier search and access to publicly available Sentinel data on AWS.

Specifications of the Sentinel Hub OpenSearch:
Service response

Documentation of OpenSearch module from sentinelhub-py Python package:
Documentation page

Documentation of OpenSearch software:
GitHub repository

 

The base URL for the Sentinel Hub OpenSearch service:

http://opensearch.sentinel-hub.com/resto/api/collections/Sentinel2/

 

Options in which format response is returned:

 

Optional Sentinel Hub OpenSearch parameters:

parameter info

MAXRECORDS

Number of results returned per request. Default is 20, maximum is 500.

INDEX

Index of the first result returned. Indexing starts from 1.

PAGE

Results are divided into pages, each containing MAXRECORDS results. This parameter specifies an index of returned page. Indexing starts from 1.

STARTDATE

Beginning of search time interval in ISO8601 format. For example: “STARTDATE=2017-11-29” or “STARTDATE=2017-11-29T18:00:21”.

COMPLETIONDATE

End of search time interval in ISO8601 format. For example: “COMPLETIONDATE=2017-11-29” or “COMPLETIONDATE=2017-11-29T18:00:21”.

IDENTIFIER

Original tile ID of Sentinel-2 L1C product provided by ESA. For example: “IDENTIFIER=S2A_OPER_MSI_L1C_TL_EPA__20170610T103721_A009443_T31SCA_N02.04”.

BOX

Bounding box defining area of interest in EPSG:4326. Order of the coordinates is: west, south, east, north.

GEOMERY

Area of Interest defined in Well Known Text (WKT) format with coordinates in EPSG:4326.

LON, LAT and RADIUS

These 3 parameters can only be used together to specify a circular search area. Parameters LON and LAT define the center of a search area and require longitude and latitude coordiantes in EPSG:4326. Parameter RADIUS is the radius of a search area and requires distance value in meters.

ORBITNUMBER

Absolute orbit number.

PUBLISHEDBEFORE

Gets results which were published before specified date. It is in ISO8601 format.

PUBLISHEDAFTER

Gets results which were published after specified date. It is in ISO8601 format.

SORTPARAM

Parameter is used to specify the parameter by which the results will be ordered. The default is “SORTPARAM=STARTDATE”.

SORTORDER

Sorting order, either "ascending" or "descending".