Bilder exportieren

Sie können Bilder aus Earth Engine im GeoTIFF- oder TFRecord-Format exportieren. Weitere Ausgabeoptionen finden Sie unter Konfigurationsparameter.

Beispiel für eine Einrichtung

Definieren Sie zuerst die Bilddaten, die exportiert werden sollen:

Code-Editor (JavaScript)

// Load a landsat image and select three bands.
var landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515')
  .select(['B4', 'B3', 'B2']);

// Create a geometry representing an export region.
var geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236]);

Python einrichten

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

# Load a landsat image and select three bands.
landsat = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_123032_20140515').select(
    ['B4', 'B3', 'B2']
)

# Create a geometry representing an export region.
geometry = ee.Geometry.Rectangle([116.2621, 39.8412, 116.4849, 40.01236])

Definieren Sie als Nächstes die Projektionsparameter, die in den folgenden Exporten verwendet werden. Mit dem Parameter crs geben wir das Koordinatensystem an und mit dem Parameter crsTransform das Pixelraster. Der Parameter crsTransform ist eine Liste von Parametern aus einer affinen Transformationsmatrix in zeilenweiser Reihenfolge [xScale, xShearing, xTranslation, yShearing, yScale, yTranslation]. Der Ursprung eines Bildes wird durch die Werte xTranslation und yTranslation definiert und die Pixelgröße des Bildes durch die Werte xScale und yScale. Beispiele für affine Matrizen ansehen

Code-Editor (JavaScript)

// Retrieve the projection information from a band of the original image.
// Call getInfo() on the projection to request a client-side object containing
// the crs and transform information needed for the client-side Export function.
var projection = landsat.select('B2').projection().getInfo();

Python einrichten

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

# Retrieve the projection information from a band of the original image.
# Call getInfo() on the projection to request a client-side object containing
# the crs and transform information needed for the client-side Export function.
projection = landsat.select('B2').projection().getInfo()

Einstellen von scale

Als Abkürzung können Sie einen scale-Parameter angeben. Earth Engine berechnet dann einen crsTransform-Parameter für Sie. Wenn Sie jedoch nur den Maßstab eines Bildes festlegen, wird der Ursprung der Projektion nicht angegeben. Dies kann dazu führen, dass ein Bild im Verhältnis zu einem anderen Bild mit derselben Pixelgröße verschoben wird.

Der Grund für die potenzielle Verschiebung ist, dass der Parameter scale verwendet wird, um die Werte xScale und yScale des crsTransform zu füllen. Die Werte xTranslation und yTranslation werden jedoch so berechnet, dass der Rest null ist, wenn sie durch die entsprechenden Werte xScale und yScale geteilt werden. Diese Parameter geben ein Pixelraster an, bei dem der Ursprung der Projektion an der Ecke eines Pixels liegt. Diese Konvention unterscheidet sich von den Übersetzungsparametern, die von einigen Datenanbietern verwendet werden. Diese verwenden Raster, die vom Ursprung der Projektion versetzt sind. Beispielsweise werden für Landsat-Bilder, die vom USGS bereitgestellt werden, Übersetzungsparameter verwendet, die um einen halben Pixel vom Ursprung der Projektion versetzt sind (15 m Versatz für die 30-m-Bänder). Für Sentinel-2-Bilder, die von der ESA bereitgestellt werden, werden dagegen Übersetzungsparameter verwendet, die am Ursprung der Projektion ausgerichtet sind. Wenn die in einem Export angegebenen crsTransform nicht mit den crsTransform des Originalbilds übereinstimmen, werden die Ausgabepixel neu abgetastet (standardmäßig mit dem nächsten Nachbarn). Dadurch wird das resultierende Bild relativ zum Originalbild verschoben.

Zusammenfassend lässt sich sagen: Wenn Sie die Pixel des exportierten Bildes mit einem bestimmten Bild abgleichen müssen, sollten Sie die Parameter crs und crsTransform verwenden, um die volle Kontrolle über das Raster zu haben.

zu Drive

Wenn Sie ein Bild in Ihr Drive-Konto exportieren möchten, verwenden Sie Export.image.toDrive(). Wenn Sie beispielsweise Teile eines Landsat-Bildes exportieren möchten, definieren Sie eine Region für den Export und rufen Sie dann Export.image.toDrive() auf:

Code-Editor (JavaScript)

// Export the image, specifying the CRS, transform, and region.
Export.image.toDrive({
  image: landsat,
  description: 'imageToDriveExample_transform',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Python einrichten

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

# Export the image, specifying the CRS, transform, and region.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToDriveExample_transform',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

Wenn dieser Code ausgeführt wird, wird im Code-Editor auf dem Tab Tasks eine Exportaufgabe erstellt. Klicken Sie neben der Aufgabe auf Ausführen, um sie zu starten. (Weitere Informationen zum Taskmanager finden Sie im Abschnitt Code-Editor.) Das Image wird in Ihrem Drive-Konto mit dem angegebenen fileFormat erstellt.

in Cloud Storage übertragen.

Verwenden Sie Export.image.toCloudStorage(), um ein Image in einen Google Cloud Storage-Bucket zu exportieren. Wenn Sie das Landsat-Bild aus dem vorherigen Beispiel nach Cloud Storage statt nach Drive exportieren möchten, verwenden Sie Folgendes:

Code-Editor (JavaScript)

// Export the image to Cloud Storage.
Export.image.toCloudStorage({
  image: landsat,
  description: 'imageToCloudExample',
  bucket: 'your-bucket-name',
  fileNamePrefix: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry
});

Python einrichten

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

# Export the image to Cloud Storage.
task = ee.batch.Export.image.toCloudStorage(
    image=landsat,
    description='imageToCloudExample',
    bucket='your-bucket-name',
    fileNamePrefix='exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
)
task.start()

Wie bei Exporten nach Google Drive starten Sie den Export über den Tab Aufgaben. Wenn Sie die exportierten Dateien wieder in Earth Engine einlesen möchten (mit ee.Image.loadGeoTIFF() oder durch Registrierung als COG-gestützte Assets), muss sich der Bucket an einem unterstützten Standort befinden.

zu Asset

Wenn Sie ein Bild in ein Asset in Ihrem Earth Engine-Asset-Ordner exportieren möchten, verwenden Sie Export.image.toAsset(). Mit dem Asset Manager können Sie Ihre Earth Engine-Assets verwalten oder prüfen, wie viel Ihres Speicherkontingents belegt ist. Im folgenden Beispiel wird gezeigt, wie Teile eines Landsat-Bildes mit unterschiedlichen Pyramidenrichtlinien für dasselbe Band exportiert werden. Die Pyramidenrichtlinie gibt an, wie Earth Engine Versionen des Assets mit niedrigerer Auflösung berechnet. Weitere Informationen dazu, wie die Earth Engine mit mehreren Auflösungen umgeht, finden Sie im Dokument zur Skalierung.

Code-Editor (JavaScript)

// Get band 4 from the Landsat image, copy it.
var band4 = landsat.select('B4').rename('b4_mean')
  .addBands(landsat.select('B4').rename('b4_sample'))
  .addBands(landsat.select('B4').rename('b4_max'));

// Export the image to an Earth Engine asset.
Export.image.toAsset({
  image: band4,
  description: 'imageToAssetExample',
  assetId: 'exampleExport',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  pyramidingPolicy: {
    'b4_mean': 'mean',
    'b4_sample': 'sample',
    'b4_max': 'max'
  }
});

Python einrichten

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

# Get band 4 from the Landsat image, copy it.
band_4 = (
    landsat.select('B4')
    .rename('b4_mean')
    .addBands(landsat.select('B4').rename('b4_sample'))
    .addBands(landsat.select('B4').rename('b4_max'))
)

# Export the image to an Earth Engine asset.
task = ee.batch.Export.image.toAsset(
    image=band_4,
    description='imageToAssetExample',
    assetId='projects/your-project/assets/exampleExport',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    pyramidingPolicy={
        'b4_mean': 'mean',
        'b4_sample': 'sample',
        'b4_max': 'max',
    },
)
task.start()

Mit dem Schlüssel '.default' können Sie eine Standard-Pyramidenrichtlinie für alle Bänder angeben, die nicht explizit angegeben sind. Sie können auch nur den Schlüssel '.default' übergeben. Wenn Sie beispielsweise für alle Bänder die Pyramidenrichtlinie „sample“ als Standard festlegen möchten, verwenden Sie {'.default': 'sample'}.

Konfigurationsparameter

Beachten Sie, dass das Wörterbuch der Konfigurationsparameter, die an Export.image übergeben werden, scale (in Metern) und die Exportregion als ee.Geometry enthält. Das exportierte Bild deckt die angegebene Region mit Pixeln im angegebenen Maßstab ab. Wenn nicht explizit angegeben, wird das CRS der Ausgabe aus dem ersten Band des zu exportierenden Bildes übernommen.

Sie können auch dimensions, crs und/oder crsTransform des exportierten Images angeben. Weitere Informationen zu crs und crsTransform finden Sie im Glossar. Wenn Sie beispielsweise einen Pixelblock genau an einer anderen Datenquelle ausrichten möchten, geben Sie dimensions, crs und crsTransform an. Wenn Sie einen Pixelblock mit einer vordefinierten Größe (z. B. ein Miniaturbild mit 256 × 256 Pixeln) erhalten möchten, der eine Region abdeckt, geben Sie dimensions und region an.

Sie können das Bildausgabeformat (wenn das Ziel nicht toAsset() ist) mit dem Parameter fileFormat (standardmäßig 'GeoTIFF') angeben.

formatOptions-Parameter

Andere Konfigurationsoptionen werden mit dem Parameter formatOptions festgelegt. Dieser sollte ein Wörterbuch sein, das nach anderen Formatoptionen sortiert ist, die für jeden fileFormat spezifisch sind, wie unten beschrieben.

GeoTIFF

Cloud Optimized GeoTIFF (COG)

Wenn Sie ein Cloud Optimized GeoTIFF (COG) exportieren möchten, setzen Sie den Schlüssel cloudOptimized in formatOptions auf true. Fortsetzung des vorherigen Beispiels:

Code-Editor (JavaScript)

// Export a cloud-optimized GeoTIFF.
Export.image.toDrive({
  image: landsat,
  description: 'imageToCOGeoTiffExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  fileFormat: 'GeoTIFF',
  formatOptions: {
    cloudOptimized: true
  }
});

Python einrichten

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

# Export a cloud-optimized GeoTIFF.
task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageToCOGeoTiffExample',
    crs=projection['crs'],
    crsTransform=projection['transform'],
    region=geometry,
    fileFormat='GeoTIFF',
    formatOptions={'cloudOptimized': True},
)
task.start()

COGs können aus Cloud Storage in ein Image neu geladen oder als Assets registriert werden. Eine vollständige Liste der Exportspezifikationen und -optionen finden Sie in der COG-Übersicht.

Nodata

Geben Sie den GeoTIFF-Nodata-Wert mit dem Schlüssel noData im Parameter formatOptions an. Beispiel:

Code-Editor (JavaScript)

// Set a nodata value and replace masked pixels around the image edge with it.
var noDataVal = -9999;
landsat = landsat.unmask(noDataVal);

Export.image.toDrive({
  image: landsat,
  description: 'imageNoDataExample',
  crs: projection.crs,
  scale: 2000,  // large scale for minimal demo
  region: landsat.geometry(),  // full image bounds
  fileFormat: 'GeoTIFF',
  formatOptions: {
    noData: noDataVal,
  }
});

Python einrichten

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

# Set a nodata value and replace masked pixels around the image edge with it.
no_data_val = -9999
landsat = landsat.unmask(no_data_val)

task = ee.batch.Export.image.toDrive(
    image=landsat,
    description='imageNoDataExample',
    crs=projection['crs'],
    scale=2000,  # large scale for minimal demo
    region=landsat.geometry(),  # full image bounds
    fileFormat='GeoTIFF',
    formatOptions={'noData': no_data_val},
)
task.start()

Beachten Sie, dass der nodata-Wert innerhalb des gültigen Bereichs für den PixelType des Bildes liegen muss. Sie können PixelType prüfen, indem Sie Bildmetadaten ausgeben und sich das Attribut data_type des ersten Bands ansehen. Sie können auch den PixelType des Bildes festlegen, indem Sie die Daten mithilfe von Bildmethoden wie toShort() oder toInt() in einen bestimmten Typ umwandeln.

TFRecord

Weitere Informationen finden Sie auf der Seite TFRecord-Datenformat.

maxPixels

Der Parameter maxPixels soll verhindern, dass versehentlich sehr große Exporte erstellt werden. Wenn der Standardwert für das gewünschte Ausgabebild zu niedrig ist, können Sie maxPixels erhöhen. Beispiel:

Export.image.toDrive({
  image: landsat,
  description: 'maxPixelsExample',
  crs: projection.crs,
  crsTransform: projection.transform,
  region: geometry,
  maxPixels: 1e9
});

Export großer Dateien

Wenn das Ausgabebild groß ist, wird es in mehrere Dateien exportiert. Wenn Sie in GeoTIFF(s) exportieren, wird das Bild in Kacheln aufgeteilt. Der Dateiname jeder Kachel hat das Format baseFilename-yMin-xMin, wobei xMin und yMin die Koordinaten der jeweiligen Kachel innerhalb des gesamten Begrenzungsrahmens des exportierten Bildes sind.

Wenn Sie nach TFRecord exportieren, werden die Dateien bei N+1-Dateien mit -00000, -00001,... -0000N angehängt. Die Beibehaltung dieser Reihenfolge ist wichtig, wenn Sie eine Inferenz für die Dateien durchführen und die Vorhersagen als Bild wieder in Earth Engine hochladen möchten. Weitere Informationen finden Sie unter Bilder als TFRecord-Dateien hochladen.

Bilder so exportieren, wie sie im Code-Editor angezeigt werden

Wenn Sie Bilder so exportieren möchten, wie sie in Earth Engine auf dem Bildschirm gerendert werden, erstellen Sie Visualisierungsbilder, wie in den Abschnitten Visualisierungsbilder und Compositing und Mosaicking beschrieben. Da der Code-Editor das CRS 'EPSG:3857' verwendet, geben Sie beim Export das CRS 'EPSG:3857' an, um ein Bild in derselben Projektion wie im Code-Editor zu erhalten. Weitere Informationen zum Festlegen der Auflösung und des Koordinatensystems der Ausgabe finden Sie im Abschnitt zum Konfigurieren von Bildexporten.