Ankündigung: Alle nicht kommerziellen Projekte, die vor dem
15. April 2025 für die Nutzung von Earth Engine registriert wurden, müssen
die Berechtigung zur nicht kommerziellen Nutzung bestätigen, um den Zugriff aufrechtzuerhalten. Wenn Sie Ihren Status nicht bis zum 26. September 2025 bestätigen, wird Ihr Zugriff möglicherweise eingeschränkt.
ee.Image.sampleRectangle
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Extrahiert einen rechteckigen Bereich von Pixeln aus einem Bild in ein ND-Array pro Band. Die Arrays werden in einem Feature zurückgegeben, das dieselben Eigenschaften wie das Bild und eine Geometrie hat, die mit der zum Sampling des Bilds verwendeten Geometrie identisch ist (oder dem Bild-Footprint, falls nicht angegeben). Jedes Band wird in seiner Eingabeprojektion gerastert. Wenn keine Geometrie angegeben ist, wird es anhand seines Footprints gerastert. Bei Skalarbereichen ist das Ausgabearray zweidimensional. Bei Array-Bändern ist das Ausgabearray (2+N)D, wobei N die Anzahl der Dimensionen im ursprünglichen Band ist. Wenn Sie Array-Bänder auswählen, müssen alle Arrays dieselbe Anzahl von Elementen haben. Wenn die Stichprobenregion eines Bands vollständig maskiert ist und ein Standard-Array-Wert angegeben ist, wird dieser anstelle der Bildstichprobe verwendet.
| Nutzung | Ausgabe |
|---|
Image.sampleRectangle(region, properties, defaultValue, defaultArrayValue) | Funktion |
| Argument | Typ | Details |
|---|
So gehts: image | Bild | Das Bild, aus dem die Stichprobe entnommen werden soll. |
region | Geometrie, Standardwert: null | Die Region, deren projizierter Begrenzungsrahmen zum Sampling des Bildes verwendet wird. Standardmäßig wird der Footprint in jedem Band verwendet. |
properties | Liste, Standard: null | Die Eigenschaften, die aus dem Beispielbild kopiert werden sollen. Standardmäßig sind alle Nicht-System-Properties ausgewählt. |
defaultValue | Gleitkommazahl, Standardwert: null | Ein Standardwert, der verwendet wird, wenn ein Stichprobenpixel maskiert ist oder außerhalb des Footprints eines Bands liegt. |
defaultArrayValue | Array, Standardwert: null | Ein Standardwert, der verwendet wird, wenn ein gesampelter Array-Pixel maskiert ist oder außerhalb des Footprints eines Bands liegt. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[],["It extracts a rectangular pixel region from an image into an ND array per band, returning a feature with the same properties and geometry as the input. Bands are sampled in their input projection using a specified region or the image footprint. Output arrays are 2D for scalar bands and (2+N)D for array bands. If a sampled region is entirely masked, a specified default value or array is used. Properties from the image can be copied.\n"]]