Which metadata fields are available for filtering cloud cover?

When users search for imagery via API, it's sensible to include a filter for cloud cover. There are several metadata fields that can be used for this task. Below is an overview:

This article is based on the following documentation:

The standard metadata field is 'cloud_cover'. 'cloud_cover' only considers the amount of clouds, meaning light or heavy haze, shadow, and snow are not counted towards this ratio. 'cloud_cover' is based on udm cloud masks, not udm2 cloud masks.

There are more cloud-related metadata fields users can use to filter data. The ones below are all based on udm2 cloud masks:

  • 'cloud_percent': Represents the percent of cloud values in the dataset. Cloud values indicate scene content areas (non-blackfilled) containing opaque clouds that prevent reliable interpretation of land cover content. This means 'cloud_percent' also accounts for haze, snow, and cloud shadow.
  • 'clear_percent': Represents the percent of clear values in a dataset. Clear values indicate scene content areas (non-blackfilled) that are deemed to be not impacted by cloud, haze, shadow, and/or snow.

There are also specific fields for haze: 'heavy_haze_percent' and 'light_haze_percent', as well as a field for cloud shadow: 'shadow_percent', and a metadata field for snow and ice: 'snow_ice_percent'.

So, if users want to avoid haze, cloud shadow, or snow and ice in the imagery they order, they can use 'cloud_percent' instead of 'cloud_cover' for filtering data.

Was this article helpful?
0 out of 0 found this helpful


1 comment
  • Hey, 

    I am looking for a way to just download cloud_percent in udm2 bands. I am using command line prompt, I followed what you have instructed but it does not seem to work. The udm2 bands still consist of all the bands rather than just the one I need. How can I solve the issue?


Please sign in to leave a comment.