Earth Engine a introduit des niveaux de quota non commerciaux pour protéger les ressources de calcul partagées et garantir des performances fiables pour tous. Les projets non commerciaux utilisent le niveau "Communauté" par défaut, mais vous pouvez modifier le niveau d'un projet à tout moment.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Export.image.toCloudStorage

Crée une tâche par lot pour exporter une image en tant que raster vers Google Cloud Storage. Les tâches peuvent être lancées 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'humain. 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. Un "/" à la fin indique un chemin d'accès. La valeur par défaut est la description de la tâche.
`dimensions`	Nombre\|Chaîne, facultative	Dimensions à utiliser pour l'image exportée. Accepte un seul entier positif comme dimension maximale ou "WIDTHxHEIGHT", où WIDTH et HEIGHT sont des entiers positifs.
`region`	Geometry.LinearRing\|Geometry.Polygon\|Chaîne, facultative	LinearRing, polygone ou coordonnées représentant la région à exporter. Ces éléments peuvent être spécifiés en tant qu'objets Geometry ou 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]\|Chaîne, facultative	Transformation affine à utiliser pour l'image exportée. Nécessite la définition de "crs".
`maxPixels`	Nombre, facultatif	Limite le nombre de pixels dans l'exportation. Par défaut, une erreur s'affiche si l'exportation dépasse 1e8 pixels. La définition explicite de cette valeur permet d'augmenter ou de réduire 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]\|Nombre, facultatif	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 découpée selon les dimensions globales de l'image. Doit être un multiple de shardSize.
`skipEmptyTiles`	Valeur booléenne, facultative	Si la valeur est "true", ignore l'écriture des tuiles d'image vides (c'est-à-dire entièrement masquées). La valeur par défaut est "false". N'est compatible qu'avec les exportations GeoTIFF.
`fileFormat`	Chaîne, facultative	Format de fichier de chaîne dans lequel l'image est exportée. Actuellement, seuls "GeoTIFF" et "TFRecord" sont compatibles. 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" (valeur booléenne), "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 9999. 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.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
  }
});

Configuration de Python

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

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 Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Exemples

Éditeur de code (JavaScript)

Colab (Python)

Export.image.toCloudStorage