ee.Filter.bounds

Crée un filtre qui est transmis si la géométrie de l'objet croise la géométrie donnée.

Attention : Fournir une collection volumineuse ou complexe comme argument geometry peut entraîner de mauvaises performances. La collation de la géométrie des collections n'est pas bien adaptée à la mise à l'échelle. Utilisez la plus petite collection (ou géométrie) requise pour obtenir le résultat souhaité.

Renvoie le filtre créé.

Utilisation	Renvoie
ee.Filter.bounds(geometry, errorMargin)	Filtre

Argument	Type	Détails
geometry	ComputedObject|FeatureCollection|Geometry	Géométrie, élément ou collection à croiser.
errorMargin	ComputedObject|Number, facultatif	Marge d'erreur facultative. Si la valeur est un nombre, elle est interprétée comme une surface de sphère en mètres.

Exemples

Éditeur de code (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)));

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

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())