Export.image.toCloudStorage

Erstellt einen Batchvorgang zum Exportieren eines Bildes als Raster nach Google Cloud Storage. Aufgaben können über den Tab „Aufgaben“ gestartet werden.

„crsTransform“, „scale“ und „dimensions“ schließen sich gegenseitig aus.

Nutzung	Ausgabe
Export.image.toCloudStorage(image, description, bucket, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)

Argument	Typ	Details
image	Bild	Das zu exportierende Bild.
description	String, optional	Ein für Menschen lesbarer Name der Aufgabe. Der Standardwert ist „myExportImageTask“.
bucket	String, optional	Der Cloud Storage-Ziel-Bucket.
fileNamePrefix	String, optional	Der String, der als Präfix für die Ausgabe verwendet wird. Ein nachgestellter „/“ gibt einen Pfad an. Standardmäßig wird die Beschreibung der Aufgabe verwendet.
dimensions	Number|String, optional	Die Dimensionen, die für das exportierte Bild verwendet werden sollen. Akzeptiert entweder eine einzelne positive Ganzzahl als maximale Dimension oder „WIDTHxHEIGHT“, wobei WIDTH und HEIGHT jeweils positive Ganzzahlen sind.
region	Geometry.LinearRing|Geometry.Polygon|String, optional	Ein LinearRing, Polygon oder Koordinaten, die die zu exportierende Region darstellen. Diese können als Geometry-Objekte oder als Koordinaten angegeben werden, die als String serialisiert sind.
scale	Nummer, optional	Auflösung in Metern pro Pixel. Der Standardwert ist 1.000.
crs	String, optional	Das für das exportierte Bild zu verwendende Koordinatenreferenzsystem.
crsTransform	List<Number>|String, optional	Die affine Transformation, die für das exportierte Bild verwendet werden soll. Erfordert die Definition von „crs“.
maxPixels	Nummer, optional	Anzahl der Pixel im Export einschränken Standardmäßig wird ein Fehler angezeigt, wenn der Export mehr als 1 × 10⁸ Pixel umfasst. Wenn Sie diesen Wert explizit festlegen, können Sie das Limit erhöhen oder senken.
shardSize	Nummer, optional	Größe der Kacheln in Pixeln, in denen dieses Bild berechnet wird. Der Standardwert ist 256.
fileDimensions	List<Number>|Number, optional	Die Abmessungen in Pixeln jeder Bilddatei, wenn das Bild zu groß ist, um in eine einzelne Datei zu passen. Sie können eine einzelne Zahl für eine quadratische Form oder ein Array mit zwei Dimensionen für (Breite, Höhe) angeben. Das Bild wird jedoch weiterhin auf die Gesamtbildabmessungen zugeschnitten. Muss ein Vielfaches von „shardSize“ sein.
skipEmptyTiles	Boolesch, optional	Falls „true“, werden keine leeren (d.h. vollständig maskierten) Bildkacheln geschrieben. Die Standardeinstellung ist "false". Wird nur bei GeoTIFF-Exporten unterstützt.
fileFormat	String, optional	Das String-Dateiformat, in das das Bild exportiert wird. Derzeit werden nur „GeoTIFF“ und „TFRecord“ unterstützt. Der Standardwert ist „GeoTIFF“.
formatOptions	ImageExportFormatConfig (optional)	Ein Dictionary mit Stringschlüsseln für formatspezifische Optionen. Für „GeoTIFF“: „cloudOptimized“ (boolesch), „noData“ (Gleitkommazahl). Für „TFRecord“: siehe https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priority	Nummer, optional	Die Priorität der Aufgabe innerhalb des Projekts. Aufgaben mit höherer Priorität werden früher geplant. Muss eine Ganzzahl zwischen 0 und 9999 sein. Die Standardeinstellung ist 100.

Beispiele

Code-Editor (JavaScript)

// A Landsat 8 surface reflectance image.
var image = ee.Image('LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508')
  .select(['SR_B.']);  // reflectance bands

// A region of interest.
var region = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20);

// Set the export "scale" and "crs" parameters.
Export.image.toCloudStorage({
  image: image,
  description: 'image_export',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export',
  region: region,
  scale: 30,
  crs: 'EPSG:5070'
});

// Use the "crsTransform" export parameter instead of "scale" for more control
// over the output grid. Here, "crsTransform" is set to align the output grid
// with the grid of another dataset. To view an image's CRS transform:
// print(image.projection())
Export.image.toCloudStorage({
  image: image,
  description: 'image_export_crstransform',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_crstransform',
  region: region,
  crsTransform: [30, 0, -2493045, 0, -30, 3310005],
  crs: 'EPSG:5070'
});

// If the export has more than 1e8 pixels, set "maxPixels" higher.
Export.image.toCloudStorage({
  image: image,
  description: 'image_export_maxpixels',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_maxpixels',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  maxPixels: 1e13
});

// Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
// parameter to true.
Export.image.toCloudStorage({
  image: image,
  description: 'image_export_cog',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_cog',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  formatOptions: {
    cloudOptimized: true
  }
});

// Define a nodata value and replace masked pixels with it using "unmask".
// Set the "sameFootprint" parameter as "false" to include pixels outside of the
// image geometry in the unmasking operation.
var noDataVal = -9999;
var unmaskedImage = image.unmask({value: noDataVal, sameFootprint: false});
// Use the "noData" key in the "formatOptions" parameter to set the nodata value
// (GeoTIFF format only).
Export.image.toDrive({
  image: unmaskedImage,
  description: 'image_export_nodata',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_nodata',
  region: image.geometry(),  // full image bounds
  scale: 2000,  // large scale for minimal demo
  crs: 'EPSG:5070',
  fileFormat: 'GeoTIFF',
  formatOptions: {
    noData: noDataVal
  }
});

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 Landsat 8 surface reflectance image.
image = ee.Image(
    'LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508'
).select(['SR_B.'])  # reflectance bands

# A region of interest.
region = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20)

# Set the export "scale" and "crs" parameters.
task = ee.batch.Export.image.toCloudStorage(
    image=image,
    description='image_export',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export',
    region=region,
    scale=30,
    crs='EPSG:5070'
)
task.start()

# Use the "crsTransform" export parameter instead of "scale" for more control
# over the output grid. Here, "crsTransform" is set to align the output grid
# with the grid of another dataset. To view an image's CRS transform:
# print(image.projection().getInfo())
task = ee.batch.Export.image.toCloudStorage(
    image=image,
    description='image_export_crstransform',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_crstransform',
    region=region,
    crsTransform=[30, 0, -2493045, 0, -30, 3310005],
    crs='EPSG:5070'
)
task.start()

# If the export has more than 1e8 pixels, set "maxPixels" higher.
task = ee.batch.Export.image.toCloudStorage(
    image=image,
    description='image_export_maxpixels',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_maxpixels',
    region=region,
    scale=30,
    crs='EPSG:5070',
    maxPixels=1e13
)
task.start()

# Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
# parameter to true.
task = ee.batch.Export.image.toCloudStorage(
    image=image,
    description='image_export_cog',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_cog',
    region=region,
    scale=30,
    crs='EPSG:5070',
    formatOptions={
        'cloudOptimized': True
    }
)
task.start()

# Define a nodata value and replace masked pixels with it using "unmask".
# Set the "sameFootprint" parameter as "false" to include pixels outside of the
# image geometry in the unmasking operation.
nodata_val = -9999
unmasked_image = image.unmask(value=nodata_val, sameFootprint=False)
# Use the "noData" key in the "formatOptions" parameter to set the nodata value
# (GeoTIFF format only).
task = ee.batch.Export.image.toDrive(
    image=unmasked_image,
    description='image_export_nodata',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_nodata',
    region=image.geometry(),  # full image bounds
    scale=2000,  # large scale for minimal demo
    crs='EPSG:5070',
    fileFormat='GeoTIFF',
    formatOptions={
       'noData': nodata_val
    }
)
task.start()