Landsat 8

About Landsat 8 Data

Mission Information

More information: USGS, Mission, Landsat8 .

Basic Facts

PropertyInfo
Spatial resolution30 m, exceptions are the thermal band with a resolution of 120 m and the panchromatic band with a resolution of 15 m.
SensorOperational Land Imager (OLI) with 9 spectral bands and Thermal Infrared Sensor (TIRS) with 2 spectral bands
Revisit time16 days
Spatial coverageWhole globe
Data availabilitySince February 2013
Common usage/purposeVegetation monitoring, land use, land cover maps and monitoring of changes.

Accessing Landsat 8 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 L8L1C data. For an overview of all API parameters see the API Reference.

Endpoint Locations

ServiceNotes
services-uswest2.sentinel-hub.com/apiGlobal coverage since February 2013

Data type identifier: L8L1C

Use L8L1C as the value of the input.data.type parameter in your API requests. This is mandatory and will ensure you get Landsat 8 data.

Filtering Options

This chapter will explain the input.data.dataFilter object of the L8L1C process API.

mosaickingOrder

Sets the order of overlapping tiles from which the output result is mosaicked. Note that tiles will in most cases come from the same orbit/acquisition. The tiling is done by ESA for easier distribution.

ValueDescriptionNotes
mostRecentselected by default. The pixel will be selected from the tile, which was acquired most recentlyin case there are more tiles available with the same timestamp (some tiles are processed by many ground stations, some are reprocessed, etc.), the one, which was downloaded from SciHub later will be used.
leastRecentsimilar to mostRecent but in reverse order
leastCCpixel is selected from tile with the least cloud coverage meta-datanote that "per tile" information is used here, each covering about a 12,000 sq. km area, so this information is only an estimate .

maxCloudCoverage

Sets the upper limit for cloud coverage in percent based on the precomputed cloud coverage estimate for each Sentinel-1 tile as present in the tile metadata. Satellite data will therefore not be retrieved for tiles with a higher cloud coverage estimate. For example, by setting the value to 20, only tiles with at most 20% cloud coverage will be used. Note that this parameter is set per tile and might not be directly applicable to the chosen area of interest.

Processing Options

This chapter will explain the input.data.processing object of the L8L1C process API.

ActionDescriptionValuesDefault
upsamplingThe same as for S2L1C.
downsamplingThe same as for S2L1C.

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.
Property nameDescriptionResolutionUnits
B01Ultra Blue (443 nm)30mREFLECTANCE
B02Blue (482 nm)30mREFLECTANCE
B03Green (561.5 nm)30mREFLECTANCE
B04Red (654.5 nm)30mREFLECTANCE
B05Near Infrared (NIR) (865 nm)30mREFLECTANCE
B06Shortwave Infrared (SWIR) 1 (1608.5 nm)30mREFLECTANCE
B07Shortwave Infrared (SWIR) 2 (2200.5 nm)30mREFLECTANCE
B08Panchromatic ( 589.5 nm)15mREFLECTANCE
B09Cirrus (1373.5 nm)30mREFLECTANCE
B10Thermal Infrared (TIRS) 1(10895 nm)100m * (30m)Brightness temperature in Kelvin
B11Thermal Infrared (TIRS) 2 (12005 nm)100m * (30m)Brightness temperature in Kelvin
dataMaskThe mask of data/no data pixels (more).N/A**0 - no data
1 - data
BQA***Quality Assessment band (QA)30mbit-packed combination (key)

*TIRS bands are acquired at 100 meter resolution, but are resampled to 30 meter in delivered data product (source). **dataMask has no source resolution as it is calculated for each output pixel. ***The values can be obtained using the utility function named decodeLs8Qa.

Catalog API Capabilities

To access Landsat 8 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

ServiceNotes
services-uswest2.sentinel-hub.com/api/v1/catalog/collections/landsat-8-l1cGlobal coverage since February 2013

Collection identifier: landsat-8-l1c

Query extension

  • eo:cloud_cover cloud cover percentage

Distinct extension

  • date