ee.ImageCollection.filterBounds

Atalho para filtrar uma coleção por interseção com geometria. Os itens da coleção com uma área que não se cruza com a geometria especificada serão excluídos.

Isso é equivalente a this.filter(ee.Filter.bounds(...)).

Cuidado: fornecer uma coleção grande ou complexa como argumento geometry pode resultar em desempenho ruim. A junção da geometria de coleções não é bem dimensionada. Use a menor coleção (ou geometria) necessária para alcançar o resultado desejado.

Retorna a coleção filtrada.

Uso	Retorna
ImageCollection.filterBounds(geometry)	Coleção

Argumento	Tipo	Detalhes
isso: collection	Coleção	A instância da coleção.
geometry	ComputedObject|FeatureCollection|Geometry	A geometria, o recurso ou a coleção para fazer a interseção.

Exemplos

Editor de código (JavaScript)

// A Sentinel-2 surface reflectance image collection for 3 months in 2021.
var ic = ee.ImageCollection('COPERNICUS/S2_SR')
             .filterDate('2021-07-01', '2021-10-01');

// A point geometry for the peak of Mount Shasta, California, USA.
var geom = ee.Geometry.Point(-122.196, 41.411);
print('Images intersecting point geometry', ic.filterBounds(geom));

// A feature collection of point geometries for mountain peaks.
var fc = ee.FeatureCollection([
  ee.Feature(ee.Geometry.Point(-122.196, 41.411), {mountain: 'Mount Shasta'}),
  ee.Feature(ee.Geometry.Point(-121.697, 45.374), {mountain: 'Mount Hood'})
]);
print('Images intersecting feature collection', ic.filterBounds(fc));

Configuração do Python

Consulte a página Ambiente Python para informações sobre a API Python e como usar geemap para desenvolvimento interativo.

import ee
import geemap.core as geemap

Colab (Python)

# A Sentinel-2 surface reflectance image collection for 3 months in 2021.
ic = ee.ImageCollection('COPERNICUS/S2_SR').filterDate(
    '2021-07-01', '2021-10-01'
)

# A point geometry for the peak of Mount Shasta, California, USA.
geom = ee.Geometry.Point(-122.196, 41.411)
print('Images intersecting point geometry:', ic.filterBounds(geom).getInfo())

# A feature collection of point geometries for mountain peaks.
fc = ee.FeatureCollection([
    ee.Feature(ee.Geometry.Point(-122.196, 41.411),
               {'mountain': 'Mount Shasta'}),
    ee.Feature(ee.Geometry.Point(-121.697, 45.374),
               {'mountain': 'Mount Hood'})
])
print('Images intersecting feature collection:', ic.filterBounds(fc).getInfo())