The Landsat 7 Enhanced Thematic Mapper (ETM+) sensor is carried onboard Landsat 7. It provides seven spectral bands and one thermal band. Learn more about Landsat 7 ETM+.
Basic Facts
| Property | Landsat 7 ETM+ L1 | Landsat 7 ETM+ L2 |
|---|
| Spatial resolution | 15 m for the panchromatic band and 30 m for the rest (the thermal band is resampled from 60 m) | 30 m (the thermal band is resampled from 60 m) |
| Sensor | Enhanced Thematic Mapper (ETM+) with 8 spectral bands and 1 thermal band | Enhanced Thematic Mapper (ETM+) with 7 spectral bands and 1 thermal band |
| Revisit time | 16 days | 16 days |
| Spatial coverage | Whole globe | Whole globe |
| Data availability | From May 1999 to January 2024 | From May 1999 to January 2024 |
Accessing 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 collection you are querying. This chapter will help you understand the parameters for Landsat 7 ETM+ Level 1 and Level 2 data. For an overview of all API parameters see the API Reference.
Endpoint Locations
| Service | Notes |
|---|
| services-uswest2.sentinel-hub.com/api | Global coverage since April 1999. All scenes collected since May 30, 2003 have data gaps due to the Scan Line Corrector (SLC) failure. |
Data type identifiers
Use the following values for input.data.type:
| Dataset | Identifier |
|---|
| Landsat 7 ETM+ Level 1 | landsat-etm-l1 (previously LETML1) |
| Landsat 7 ETM+ Level 2 | landsat-etm-l2 (previously LETML2) |
Filtering Options
This chapter explains the input.data.dataFilter object.
mosaickingOrder
| Value | Description | Notes |
|---|
| mostRecent | (default) The pixel is selected from the most recently acquired tile | |
| leastRecent | Same as mostRecent, but in reverse order | |
| leastCC | Pixel selected from tile with lowest cloud coverage | Estimated per tile (each covering ~31,100 sq. km); local cloud coverage may differ |
maxCloudCoverage
Sets the upper limit for cloud coverage in percent based on the precomputed cloud coverage estimate for each 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.
tiers
Level 1 tiers
| Value | Description |
|---|
| TIER_1 | Tier 1 products |
| TIER_1_AND_RT | Tier 1 and Real-Time products |
| ALL_TIERS | Default. Tier 1, Tier 2, and Real-Time products |
Level 2 tiers
| Value | Description |
|---|
| TIER_1 | Tier 1 products |
| ALL_TIERS | Default. Tier 1 and Tier 2 products |
Processing Options
Available Bands and Data
Landsat 7 ETM+ Level 1 Bands
| Name | Description | Resolution |
|---|
| B01 | Blue (450–520 nm) | 30 m |
| B02 | Green (520–600 nm) | 30 m |
| B03 | Red (630–690 nm) | 30 m |
| B04 | Near Infrared (770–900 nm) | 30 m |
| B05 | SWIR 1 (1550–1750 nm) | 30 m |
| B06_VCID_1, B06_VCID_2 | Thermal Infrared (10400–12500 nm) | 30 m [1] |
| B07 | SWIR 2 (2090–2350 nm) | 30 m |
| B08 | Panchromatic (520–900 nm) | 15 m |
| BQA | Quality Assessment band | 30 m |
| QA_RADSAT | Radiometric Saturation QA Band | 30 m |
| VAA | View Azimuth Angle | 30 m |
| VZA | View Zenith Angle | 30 m |
| SAA | Sun Azimuth Angle | 30 m |
| SZA | Sun Zenith Angle | 30 m |
| dataMask | Data/no-data mask | N/A [2] |
Landsat 7 ETM+ Level 2 Bands
| Name | Description | Resolution |
|---|
| B01–B05, B07 | Surface reflectance bands | 30 m |
| B06 | Surface temperature | 30 m [1] |
| BQA | Quality Assessment band | 30 m |
| QA_RADSAT | Radiometric Saturation QA Band | 30 m |
| ST_QA | Surface temperature uncertainty | 30 m |
| ST_TRAD | Thermal radiance | 30 m |
| ST_URAD | Upwelled radiance | 30 m |
| ST_DRAD | Downwelled radiance | 30 m |
| ST_ATRAN | Atmospheric transmittance | 30 m |
| ST_EMIS | Emissivity | 30 m |
| ST_EMSD | Emissivity standard deviation | 30 m |
| ST_CDIST | Pixel distance to cloud | 30 m |
| dataMask | Data/no-data mask | N/A [2] |
[1]: Thermal band is acquired at 60 m and resampled to 30 m.
[2]: Calculated per output pixel.
Units
Landsat 7 ETM+ Level 1 Units
| Band type | Physical Quantity | Units Value | Source Format |
|---|
| Optical bands | Reflectance | REFLECTANCE | UINT8 |
| Thermal bands | Brightness temperature (K) | BRIGHTNESS_TEMPERATURE | UINT8 |
| QA bands | Quality flags | DN | UINT16 |
| Angles | Degrees | DEGREES | INT16 |
| dataMask | Data mask | DN | N/A |
Landsat 7 ETM+ Level 2 Units
| Band type | Physical Quantity | Units Value | Source Format |
|---|
| Optical bands | Surface reflectance | REFLECTANCE | UINT16 |
| Thermal band | Surface temperature (K) | SURFACE_TEMPERATURE | UINT16 |
| QA and auxiliary bands | Various | DN / FRACTION / RADIANCE | INT16 |
Scenes Object
scenes object stores metadata. An example of metadata available in scenes object for Landsat ETM L1 and L2 when mosaicking is ORBIT:
| Property name | Value |
|---|
| dateFrom | '2020-07-30T00:00:00Z' |
| dateTo | '2020-07-30T23:59:59Z' |
| tiles[i].landsatEtmProductId | 'LE07_L1TP_119019_20200730_20200909_02_T1' |
| tiles[i].date | '2020-07-30T01:52:34.528Z' |
| tiles[i].shId | 3097841 |
| tiles[i].cloudCoverage | 98.35 |
| tiles[i].dataPath | 'https://usgs-landsat.s3.amazonaws.com/collection02/level-1/standard/etm/2020/119/019/LE07_L1TP_119019_20200730_20200909_02_T1' |
Properties of a scenes object can differ depending on the selected mosaicking and in which evalscript function the object is accessed. Working with metadata in evalscript user guide explains all details and provide examples.
Catalog API Capabilities
To access Landsat 7 ETM+ metadata, send a search request to the Catalog API.
Collection identifiers
landsat-etm-l1landsat-etm-l2
Filter extension
eo:cloud_coverlandsat:scene_idlandsat:collection_category
Distinct extension