Export.image.toCloudStorage

Crée une tâche par lot pour exporter une image en tant que raster vers Google Cloud Storage. Vous pouvez lancer des tâches depuis l'onglet "Tâches".

"crsTransform", "scale" et "dimensions" s'excluent mutuellement.

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

Argument	Type	Détails
image	Image	Image à exporter.
description	Chaîne, facultative	Nom de la tâche lisible par l'utilisateur. La valeur par défaut est "myExportImageTask".
bucket	Chaîne, facultative	Bucket Cloud Storage de destination.
fileNamePrefix	Chaîne, facultative	Chaîne utilisée comme préfixe de la sortie. Une barre oblique de fin "/" indique un chemin d'accès. La valeur par défaut est la description de la tâche.
dimensions	Number|String, facultatif	Dimensions à utiliser pour l'image exportée. Accepte un seul entier positif comme dimension maximale ou "WIDTHxHEIGHT", où WIDTH et HEIGHT sont chacun des entiers positifs.
region	Geometry.LinearRing|Geometry.Polygon|String, facultatif	Un LinearRing, un polygone ou des coordonnées représentant la région à exporter. Ils peuvent être spécifiés sous forme d'objets Geometry ou de coordonnées sérialisées sous forme de chaîne.
scale	Nombre, facultatif	Résolution en mètres par pixel. La valeur par défaut est 1 000.
crs	Chaîne, facultative	CRS à utiliser pour l'image exportée.
crsTransform	List<Number>|String, facultatif	Transformation affine à utiliser pour l'image exportée. Nécessite la définition de "crs".
maxPixels	Nombre, facultatif	Limitez le nombre de pixels dans l'exportation. Par défaut, une erreur s'affiche si l'exportation dépasse 1e8 pixels. Définir explicitement cette valeur permet d'augmenter ou de diminuer cette limite.
shardSize	Nombre, facultatif	Taille en pixels des tuiles dans lesquelles cette image sera calculée. La valeur par défaut est 256.
fileDimensions	List<Number>|Number, optional	Dimensions en pixels de chaque fichier image, si l'image est trop grande pour tenir dans un seul fichier. Vous pouvez spécifier un seul nombre pour indiquer une forme carrée ou un tableau de deux dimensions pour indiquer (largeur, hauteur). Notez que l'image sera toujours rognée selon les dimensions globales de l'image. Doit être un multiple de shardSize.
skipEmptyTiles	Booléen, facultatif	Si la valeur est "true", ignorez l'écriture des tuiles d'image vides (c'est-à-dire entièrement masquées). Valeur par défaut : "false". Uniquement compatible avec les exportations GeoTIFF.
fileFormat	Chaîne, facultative	Format de fichier de chaîne dans lequel l'image est exportée. Actuellement, seuls les formats "GeoTIFF" et "TFRecord" sont acceptés. La valeur par défaut est "GeoTIFF".
formatOptions	ImageExportFormatConfig, facultatif	Dictionnaire de clés de chaîne pour les options spécifiques au format. Pour "GeoTIFF" : "cloudOptimized" (booléen), "noData" (float). Pour "TFRecord", consultez https://developers.google.com/earth-engine/guides/tfrecord#formatoptions.
priority	Nombre, facultatif	Priorité de la tâche dans le projet. Les tâches à priorité élevée sont planifiées plus tôt. Veuillez saisir un nombre entier compris entre 0 et 9 999. La valeur par défaut est 100.

Exemples

Éditeur de code (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
  }
});

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

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