ee.Image.clipToBoundsAndScale

Schneidet ein Bild auf die Grenzen einer Geometrie zu und skaliert das zugeschnittene Bild auf eine bestimmte Größe oder einen bestimmten Maßstab.

Achtung :Wenn Sie eine große oder komplexe Sammlung als geometry-Argument angeben, kann dies zu einer schlechten Leistung führen. Das Zusammenführen der Geometrie von Sammlungen ist nicht gut skalierbar. Verwenden Sie die kleinste Sammlung (oder Geometrie), die für das gewünschte Ergebnis erforderlich ist.

Nutzung	Ausgabe
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	Bild

Argument	Typ	Details
So gehts: input	Bild	Das Bild, das zugeschnitten und skaliert werden soll.
geometry	Geometrie, Standardwert: null	Die Geometrie, auf die das Bild zugeschnitten werden soll. Das Bild wird in der Projektion dieser Geometrie auf den Begrenzungsrahmen zugeschnitten.
width	Ganzzahl, Standard: null	Die Breite, auf die das Bild skaliert werden soll, in Pixeln. Muss zusammen mit „height“ angegeben werden. Wird nur mit „maxDimension“ und „scale“ verwendet.
height	Ganzzahl, Standard: null	Die Höhe, auf die das Bild skaliert werden soll, in Pixeln. Muss zusammen mit „width“ angegeben werden. Wird nur mit „maxDimension“ und „scale“ verwendet.
maxDimension	Ganzzahl, Standard: null	Die maximale Dimension, auf die das Bild skaliert werden soll, in Pixeln. Schließt „width“, „height“ und „scale“ aus.
scale	Gleitkommazahl, Standardwert: null	Wenn „scale“ angegeben ist, wird die Projektion skaliert, indem der angegebene Skalierungswert durch die nominelle Größe eines Meters in der Projektion des Bildes dividiert wird. Schließt „width“, „height“ und „maxDimension“ aus.

Beispiele

Code-Editor (JavaScript)

// A digital elevation model.
var dem = ee.Image('NASA/NASADEM_HGT/001');
var demVis = {bands: 'elevation', min: 0, max: 2000};
print('DEM', dem);
Map.setCenter(-121.38, 46.51, 8);
Map.addLayer(dem, demVis, 'DEM');

// Clip DEM by a single polygon geometry, specify width and height parameters.
var geom1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98);
var demClip1 = dem.clipToBoundsAndScale({
  geometry: geom1,
  width: 20,  // pixels
  height: 10  // pixels
});
print('Clipped image retains metadata and band names', demClip1);
Map.addLayer(demClip1, demVis, 'Single geometry clip (width, height)');
Map.addLayer(geom1, {color: 'red'}, 'Single geometry (width, height)');

// Clip DEM by a single polygon geometry, specify maxDimension parameter.
var geom2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81);
var demClip2 = dem.clipToBoundsAndScale({
  geometry: geom2,
  maxDimension: 5,  // pixels
});
Map.addLayer(demClip2, demVis, 'Single polygon clip (maxDimension)');
Map.addLayer(geom2, {color: 'yellow'}, 'Single polygon (maxDimension)');

// Clip DEM by a single polygon geometry, specify scale parameter.
var geom3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41);
var demClip3 = dem.clipToBoundsAndScale({
  geometry: geom3,
  scale: 1e4,  // meters
});
Map.addLayer(demClip3, demVis, 'Single polygon clip (scale)');
Map.addLayer(geom3, {color: 'blue'}, 'Single polygon (scale)');

Python einrichten

Informationen zur Python API und zur Verwendung von geemap für die interaktive Entwicklung finden Sie auf der Seite Python-Umgebung.

import ee
import geemap.core as geemap

Colab (Python)

# A digital elevation model.
dem = ee.Image('NASA/NASADEM_HGT/001')
dem_vis = {'bands': 'elevation', 'min': 0, 'max': 2000}
display('DEM', dem)
m = geemap.Map()
m.set_center(-121.38, 46.51, 8)
m.add_layer(dem, dem_vis, 'DEM')

# Clip DEM by a single polygon geometry, specify width and height parameters.
geom_1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98)
dem_clip_1 = dem.clipToBoundsAndScale(geometry=geom_1, width=20, height=10)
display('Clipped image retains metadata and band names', dem_clip_1)
m.add_layer(dem_clip_1, dem_vis, 'Single geometry clip (width, height)')
m.add_layer(geom_1, {'color': 'red'}, 'Single geometry (width, height)')

# Clip DEM by a single polygon geometry, specify maxDimension parameter.
geom_2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81)
dem_clip_2 = dem.clipToBoundsAndScale(geometry=geom_2, maxDimension=5)
m.add_layer(dem_clip_2, dem_vis, 'Single polygon clip (maxDimension)')
m.add_layer(geom_2, {'color': 'yellow'}, 'Single polygon (maxDimension)')

# Clip DEM by a single polygon geometry, specify scale parameter.
geom_3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41)
dem_clip_3 = dem.clipToBoundsAndScale(geometry=geom_3, scale=1e4)
m.add_layer(dem_clip_3, dem_vis, 'Single polygon clip (scale)')
m.add_layer(geom_3, {'color': 'blue'}, 'Single polygon (scale)')
m