Sentinel-5P L2
About Sentinel-5P Data
Sentinel Hub supports Sentinel-5P level 2 (L2) data products as provided by ESA. General information about the satellite and specifically Level 2 data is available here: http://www.tropomi.eu/data-products/level-2-products. Raw bands (Level 1 products) are not available in Sentinel Hub.
Mission Information
The Sentinel-5P (P for precursor) mission aims at providing information and services on air quality and climate between 2017 and at least 2023. With the TROPOMI sensor on board it makes daily global observations of key atmospheric constituents, including ozone, nitrogen dioxide, sulfur dioxide, carbon monoxide, methane, formaldehyde as well as cloud and aerosol properties. The mission aims at ensuring data continuity between the retirement of the Envisat satellite and NASA's Aura mission and the launch of Sentinel-5 (source: ESA).
Basic Facts
| Property | Info |
|---|---|
| Spatial resolution | Up to 5.5 km x 3.5 km. |
| Sensor | Tropospheric Monitoring Instrument (TROPOMI), a spectrometer measuring ultraviolet and visible (270–495 nm), near infrared (675–775 nm) and shortwave infrared (2305–2385 nm) light. |
| Revisit time | Less than one day. |
| Spatial coverage | Global coverage. |
| Data availability | Since April 2018. |
| Common usage/purpose | To provide global information on a multitude of atmospheric trace gases, aerosols and cloud distributions affecting air quality and climate. |
(Source: ESA.)
Attribution and Use
EU law grants free access to Copernicus Sentinel Data and Service Information for the purpose of the following use in so far as it is lawful: a) reproduction; b) distribution; c) communication to the public; d) adaptation, modification and combination with other data and information; e) any combination of points a to d.
See more details on the use of Copernicus Sentinel data and service information here. Tracing based on Sentinel imagery is allowed for commercial purposes as well.
Acknowledgment or credit: Contains modified Copernicus Sentinel data [Year] processed by Sentinel Hub
Accessing Sentinel-5P Data
To access data you need to send a POST request to our process API. The requested data will be returned as the response to your request. Each POST request can be tailored to get you exactly the data you require. To do this requires setting various parameters which depend on the datasource you are querying. This chapter will help you understand the parameters for S5PL2 data. To see examples of such requests go here, and for an overview of all API parameters see the API Reference.
Endpoint Locations
| Service | Notes |
|---|---|
| creodias.sentinel-hub.com/api/v1/ | Global coverage since May 2018 |
Data type identifier: S5PL2
Use S5PL2 as the value of the input.data.type parameter in your API requests. This is mandatory and will ensure you get Sentinel-5P L2 data.
Filtering Options
This chapter will explain the input.data.dataFilter object of the S5PL2 process API.
timeRange
For simple mosaicking, the time range which is requested is clipped to start at most 24 hours before the to date-time. The reason for this is that Sentinel-5P covers the globe in one day therefore longer time ranges are not neccessary. The limitation also improves the responsiveness of Sentinel Hub.
mosaickingOrder
Sets the order of sources from which the output result is mosaicked. If there are multiple sources available for the same time, unless explicitly set otherwise, Sentinel Hub will take the source with the slowest timeliness (i.e. RPRO prefered to OFFL prefered to NRTI).
| Value | Description |
|---|---|
| mostRecent | the pixel will be selected from the tile, which was acquired most recently |
| leastRecent | similar to mostRecent but in reverse order |
timeliness
You can force the timeliness of the requested data. If not set and there are multiple sources available for the same time, Sentinel Hub will take the source with the slowest timeliness (RPRO prefered to OFFL prefered to NRTI). To explicitly set, the options are:
- NRTI for near realtime,
- OFFL for offline,
- RPRO for reprocessing.
Processing Options
This chapter will explain the input.data.processing object of the S5PL2 process API.
| Action | Description | Values | Default |
|---|---|---|---|
| upsampling | Defines the interpolation used for processing when the pixel resolution is greater than the source resolution (e.g. 5m/px with a 10m/px source) | NEAREST - nearest neighbour interpolation BILINEAR - bilinear interpolation BICUBIC - bicubic interpolation | NEAREST |
| downsampling | As above except when the resolution is lower. | NEAREST - nearest neighbour interpolation BILINEAR - bilinear interpolation BICUBIC - bicubic interpolation | NEAREST |
| minQa | Sentinel-5P data is flagged with quality values (“qa_value”). minQa is the minimum (inclusive) pixel quality to be displayed in percent. For example, setting minQa = 75 will only display pixels with qa_value >= 75% | Values between 0 and 100. | 75 For NO2 50 for other products |
Available Bands and Data
Information in this chapter is useful when defining input object in evalscript: any string listed in the column Name can be an element of the input.bands array in your evalscript.
| Name | Description | Resolution* [km2] | Units |
|---|---|---|---|
| AER_AI_340_380 AER_AI_354_388 | UV Aerosol Index also referred to as the "Ultraviolet Aerosol Index". Two products are available the difference being in the bands which are used in the calculation of the index. E.g. for AER_AI_340_380 the index was calculated based on measurements at wavelengths of 340 nm and 380 nm. More. | up to 5.5 x 3.5 | N/A |
| CLOUD_BASE_HEIGHT CLOUD_BASE_PRESSURE CLOUD_FRACTION CLOUD_OPTICAL_THICKNESS CLOUD_TOP_HEIGHT CLOUD_TOP_PRESSURE | Cloud related data. More products are available: fraction, optical thickness (albedo), top and base pressure and height. More. | up to 5.5 x 3.5 | meters pascals N/A N/A meters pascals |
| CO | Carbon monoxide, more. | up to 5.5 x 7 | mol/m2 |
| HCHO | Formaldehyde, more. | up to 5.5 x 3.5 | mol/m2 |
| NO2 | Nitrogen oxide, more. | up to 5.5 x 3.5 | mol/m2 |
| O3 | Ozone, more. | up to 5.5 x 3.5 | mol/m2 |
| SO2 | Sulphur dioxide, more. | up to 5.5 x 3.5 | mol/m2 |
| CH4 | Methane, more. | up to 5.5 x 7 | ppb |
* E.g., "5.5 x 3.5" means a spatial resolution of 5.5 km in the satellite flight direction and 3.5 km in the perpendicular direction at nadir. Spatial resolutions in the table are given for data released after 6 August 2019 when the spatial resolution in the flight direction was improved from 7 km to 5.5 km (see ESA news).
Mosaicking
SIMPLE and ORBIT mosaicking types are supported.
Scene Object
This chapter will explain the evalscript evaluatePixel scene object.
The scene object contains following properties (when mosaicking: "ORBIT" ):
| Property name | Description | Type |
|---|---|---|
| date | Scene sensing time | JavaScript Date object |
Dataset Specific Constraints
The raw data is encoded as 32-bit float samples. For scientific usage it is best to set tiff as an output format and sampleType: SampleType.FLOAT32.
Sentinel-5P data can potentially contain many no data pixels which is a consequence of the way it is measured. We therefore suggest using the dataMask band to differentiate between actual zero values and no data.
Catalog API Capabilities
To access Sentinel 5P L2 product metadata you need to send search request to our Catalog API. The requested metadata will be returned as JSON formatted response to your request.
Endpoint Locations
| Service | Notes |
|---|---|
| creodias.sentinel-hub.com/api/v1/catalog/collections/sentinel-5p-l2 | |
| shservices.mundiwebservices.com/api/v1/catalog/collections/sentinel-5p-l2 |
Collection identifier: sentinel-5p-l2
Query extension
type(available types)orbit_idtimeliness(possible values)
Distinct extension
datetype(available types)