ee.Filter.bounds

Cria um filtro que é aprovado se a geometria do objeto intersecta a geometria especificada.

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 o filtro construído.

Uso	Retorna
ee.Filter.bounds(geometry, errorMargin)	Filtro

Argumento	Tipo	Detalhes
geometry	ComputedObject|FeatureCollection|Geometry	A geometria, o recurso ou a coleção para fazer a interseção.
errorMargin	ComputedObject|Number, opcional	Uma margem de erro opcional. Se for um número, será interpretado como metros quadrados da superfície da esfera.

Exemplos

Editor de código (JavaScript)

// collection.filterBounds() is preferred.
// 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.filter(ee.Filter.bounds(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.filter(ee.Filter.bounds(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)

# collection.filterBounds() is preferred.
# 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.filter(ee.Filter.bounds(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.filter(ee.Filter.bounds(fc)).getInfo())