Die Earth Engine hat nicht kommerzielle Kontingentstufen eingeführt, um gemeinsam genutzte Rechenressourcen zu schützen und eine zuverlässige Leistung für alle sicherzustellen. Für nicht kommerzielle Projekte wird standardmäßig die Community-Stufe verwendet. Sie können die Stufe eines Projekts aber jederzeit ändern.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Export.image.toCloudStorage

Erstellt einen Batchjob zum Exportieren eines Bilds als Raster nach Google Cloud Storage. Jobs können über den Tab „Jobs“ 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. Standardmäßig wird „myExportImageTask“ verwendet.
`bucket`	String, optional	Der Ziel-Bucket von Cloud Storage.
`fileNamePrefix`	String, optional	Der String, der als Präfix für die Ausgabe verwendet wird. Ein nachgestelltes „/“ gibt einen Pfad an. Standardmäßig wird die Beschreibung der Aufgabe verwendet.
`dimensions`	Zahl\|String, optional	Die Abmessungen, die für das exportierte Bild verwendet werden sollen. Es kann entweder eine einzelne positive Ganzzahl als maximale Abmessung oder „BREITExHÖHE“ verwendet werden, wobei BREITE und HÖHE 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 String serialisierte Koordinaten angegeben werden.
`scale`	Zahl, optional	Auflösung in Metern pro Pixel. Standardwert ist 1.000.
`crs`	String, optional	Das für das exportierte Bild zu verwendende CRS.
`crsTransform`	Liste[Zahl]\|String, optional	Die affine Transformation, die für das exportierte Bild verwendet werden soll. Dazu muss „crs“ definiert sein.
`maxPixels`	Zahl, optional	Beschränken Sie die Anzahl der Pixel im Export. Standardmäßig wird eine Fehlermeldung angezeigt, wenn der Export 1e8 Pixel überschreitet. Wenn Sie diesen Wert explizit festlegen, können Sie dieses Limit erhöhen oder senken.
`shardSize`	Zahl, optional	Die Größe der Kacheln in Pixel, in denen dieses Bild berechnet wird. Standardwert ist 256.
`fileDimensions`	Liste[Zahl]\|Zahl, optional	Die Abmessungen in Pixeln jeder Bilddatei, wenn das Bild zu groß für eine einzelne Datei ist. Sie können eine einzelne Zahl angeben, um eine quadratische Form anzugeben, oder ein Array mit zwei Abmessungen, um (Breite, Höhe) anzugeben. Das Bild wird jedoch weiterhin auf die Gesamtbildabmessungen zugeschnitten. Muss ein Vielfaches von „shardSize“ sein.
`skipEmptyTiles`	Boolesch, optional	Wenn „true“, werden leere (d.h. vollständig maskierte) Bildkacheln nicht geschrieben. Die Standardeinstellung ist „false“. Wird nur für GeoTIFF-Exporte unterstützt.
`fileFormat`	String, optional	Das String-Dateiformat, in das das Bild exportiert wird. Derzeit werden nur „GeoTIFF“ und „TFRecord“ unterstützt. Standardmäßig wird „GeoTIFF“ verwendet.
`formatOptions`	ImageExportFormatConfig, optional	Ein Dictionary mit Stringschlüsseln für formatspezifische Optionen. Für „GeoTIFF“: „cloudOptimized“ (boolesch), „noData“ (Gleitkommazahl). Für „TFRecord“: https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
`priority`	Zahl, optional	Die Priorität der Aufgabe im Projekt. 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.toCloudStorage({
  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

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)

# 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:
# display(image.projection())
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.toCloudStorage(
    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()

Export.image.toCloudStorage Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Beispiele

Code-Editor (JavaScript)

Colab (Python)

Export.image.toCloudStorage