Copy for LLM[View as Markdown](https://docs.planet.com/data/public-data/usgs-nasa/landsat-7-etm/) # Landsat 7 ETM+ L1 & L2 ![Header Thumbnail](/data/public-data/landsat-7-etm/thumbnail.webp) 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+](https://www.usgs.gov/search?keywords=USGS+EROS+Archive+-+Landsat+Archives+-+Landsat+7+Enhanced+Thematic+Mapper+Plus+%28ETM%2B%29). ## 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](https://docs.planet.com/develop/apis/processing/reference.md). ### 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 | Parameter | Description | | ------------ | ----------------------------------------------------------------------------------------------------------- | | upsampling | [Same as Sentinel-2.](https://docs.planet.com/data/public-data/copernicus/sentinel-2.md#processing-options) | | downsampling | [Same as Sentinel-2.](https://docs.planet.com/data/public-data/copernicus/sentinel-2.md#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](https://docs.planet.com/develop/evalscripts/functions.md#scenes) 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](https://docs.planet.com/develop/evalscripts.md#working-with-metadata-in-evalscripts) 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](https://docs.planet.com/develop/apis/catalog/reference.md). ### Collection identifiers * `landsat-etm-l1` * `landsat-etm-l2` ### Filter extension * `eo:cloud_cover` * `landsat:scene_id` * `landsat:collection_category` ### Distinct extension * `date`