Apply search settings

The search settings help you apply filters to refine your results when searching for imagery. These search settings are heavily based on your active search service as the metadata within this service defines which filters are available for use. If the active image service contains the supported metadata, you can apply the following filters; Date Range, Cloud Cover, Predicted NIIRS, Obliquity, and Image Name. If the metadata for these filters do not exist in your active search service, these filters will not display in your search settings tab. An Area of Interest filter will always be available regardless of your active search service.

Once a search setting is applied and a search is run, the map pans and zooms to the extent of the results, footprints appear on the map, and results appear on the Search Results tab, if images from the active imagery layer exist based on the defined filters.

If no images from the active imagery layer exist based on the defined filters, a message stating such appears on the Search Results tab.

Since there are multiple search settings you can enable at a time, you can view a summary of your current search settings below the search map.

Area of Interest filter

You can use the geometry tools on the Search Settings tab to discover imagery within a specific area of interest.

To apply an area of interest filter, complete the following steps:

  1. On the Search Settings tab, expand Area of Interest Filter.
  2. Click a geometry to search for imagery where the footprints intersect with the defined area of interest:
    • Point—Click on the map to drop a point.
    • Line—Click on the map to draw a segment. Double-click to complete the line.
    • Polygon—Click on the map to define a side. Double-click to complete the polygon.
    • Rectangle—Click and drag on the map to draw a rectangle.
    • Circle—Click and drag on the map to draw a circle.
  3. Once a geometry has been drawn on the map, click Run Search to perform a search based on the defined geometry.
  4. Optionally click Clear Drawn Graphics to remove the geometry graphic from the map.

Date Range filter

The Date Range Filter lets you narrow your search results based on a preferred start date, end date, or range. If a specific time frame is chosen, then all images from the specified range will be returned. If only a start date or end date is specified, then all images after the start date and before the end date are returned respectively. If the active image service does not have metadata based on time, then this search setting will not appear.

To use the date range filter:

  1. Click the Search Settings tab.
  2. Expand the Date Range Filter.
  3. Choose your desired Start Date and/or End Date from the calendar picker.

    Your specified date range will appear.

  4. Note:

    By default, the Date Range Filter will be set to the oldest image (Start Date) and the newest image (End Date) in the collection. You cannot pick a date beyond this date range threshold.

  5. Click Run Search to complete your search.

Cloud Cover filter

The Cloud Cover Filter lets you narrow your search results based on the maximum cloud cover percentage you want returned. Once the filter is set, only those images whose cloud cover metadata does not exceed the specified value are returned.

To use the Cloud Cover Filter:

  1. Click the Search Settings tab.
  2. Expand the Cloud Cover Filter.
  3. Move the slider to your desired maximum cloud coverage percentage.

    The indicated percentage appears above the slider and changes dynamically.

  4. Click Run Search to complete your search.

Predicted NIIRS Filter

The Predicted NIIRS Filter lets you narrow your search results based on the minimum amount of detail you want to see in your imagery. This filter ranges from 0.1 to 9.0 increasing every tenth (0.1) of a decimal. Once the filter is set, only those images whose Predicted NIIRS values are equal to or above your specified value are returned.

To use the Predicted NIIRS Filter:

  1. Click the Search Settings tab.
  2. Expand the Predicted NIIRS Filter.
  3. Move the slider to your desired Predicted NIIRS value.

    The indicated value appears beside the slider and changes dynamically.

  4. Click Run Search to complete your search.

Obliquity filter

The Obliquity Filter lets you narrow your search results based on the minimum obliquity angle. Once the filter is set, only those images whose degrees of obliqueness are equal to or above your specified value are returned.

To use the Obliquity Filter:

  1. Click the Search Settings tab.
  2. Expand the Obliquity Filter.
  3. Move the slider to your preferred degrees of obliqueness.

    The indicated degree of obliqueness appears on the top of the slider and changes dynamically.

  4. Click Run Search to complete your search.

Image Name filter

The Image Name Filter lets you narrow your search results based on a specific image name. Once the filter is set, only those image whose name matches your specified input are returned.

To use the Image Name Filter

  1. Click the Search Settings tab.
  2. Expand the Image Name Filter.
  3. Enter in the desired image name.
  4. Click Run Search to complete your search.