sentinelhub.api.opensearch
Module for communication with Sentinel Hub Opensearch service.
For more search parameters check service description.
- exception sentinelhub.api.opensearch.TileMissingException[source]
Bases:
Exception
This exception is raised when requested tile is missing at Sentinel Hub Opensearch service
- sentinelhub.api.opensearch.get_tile_info_id(tile_id)[source]
Get basic information about image tile
- Parameters
tile_id (str) – original tile identification string provided by ESA (e.g. ‘S2A_OPER_MSI_L1C_TL_SGS__20160109T230542_A002870_T10UEV_N02.01’)
- Returns
dictionary with info provided by Opensearch REST service
- Raises
TileMissingException if no tile with tile ID tile_id exists
- Return type
- sentinelhub.api.opensearch.get_tile_info(tile, time, aws_index=None, all_tiles=False)[source]
Get basic information about image tile
- Parameters
- Returns
dictionary (or list of dictionaries) with info provided by Opensearch REST service
- Return type
- sentinelhub.api.opensearch.get_area_info(bbox, date_interval, maxcc=None)[source]
Get information about all images from specified area and time range
- Parameters
- Returns
iterator of dictionaries containing info provided by Opensearch REST service
- Return type
- sentinelhub.api.opensearch.get_area_dates(bbox, date_interval, maxcc=None)[source]
Get list of times of existing images from specified area and time range
- Parameters
- Returns
list of time strings in ISO8601 format
- Return type
- sentinelhub.api.opensearch.reduce_by_maxcc(result_list, maxcc)[source]
Filter list image tiles by maximum cloud coverage
- Parameters
- Returns
list of dictionaries containing info provided by Opensearch REST service
- Return type
- sentinelhub.api.opensearch.search_iter(tile_id=None, bbox=None, start_date=None, end_date=None, absolute_orbit=None, config=None)[source]
A generator function that implements OpenSearch search queries and returns results
All parameters for search are optional.
- Parameters
tile_id (Optional[str]) – original tile identification string provided by ESA (e.g. ‘S2A_OPER_MSI_L1C_TL_SGS__20160109T230542_A002870_T10UEV_N02.01’)
start_date (Union[None, str, date]) – beginning of time range
absolute_orbit (Optional[int]) – An absolute orbit number of Sentinel-2 L1C products as defined by ESA
config (Optional[SHConfig]) – A custom instance of config class to override parameters from the saved configuration.
- Returns
An iterator returning dictionaries with info provided by Sentinel Hub OpenSearch REST service
- Return type