Export.image.toAsset

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

Utilisation	Renvoie
Export.image.toAsset(image, description, assetId, pyramidingPolicy, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, 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".
assetId	Chaîne, facultative	ID de l'élément de destination.
pyramidingPolicy	Objet, facultatif	Stratégie de pyramidation à appliquer à chaque bande de l'image, associée au nom de la bande. Les valeurs doivent être l'une des suivantes : moyenne, échantillon, min, max ou mode. La valeur par défaut est "mean". Une clé spéciale, ".default", peut être utilisée pour modifier la valeur par défaut de toutes les bandes.
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.
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.toAsset({
  image: image,
  description: 'image_export',
  assetId: 'projects/<project-name>/assets/<asset-name>',  // <> modify these
  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.toAsset({
  image: image,
  description: 'image_export_crstransform',
  assetId: 'projects/<project-name>/assets/<asset-name>',  // <> modify these
  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.toAsset({
  image: image,
  description: 'image_export_maxpixels',
  assetId: 'projects/<project-name>/assets/<asset-name>',  // <> modify these
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  maxPixels: 1e13
});

// The default "pyramidingPolicy" is mean. If data are categorical,
// consider mode.
Export.image.toAsset({
  image: image.select('SR_B5'),
  description: 'image_export_pyramiding',
  assetId: 'projects/<project-name>/assets/<asset-name>',  // <> modify these
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  pyramidingPolicy: {SR_B5: 'mode'}
});

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.toAsset(
    image=image,
    description='image_export',
    assetId='projects/<project-name>/assets/<asset-name>',  # <> modify these
    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.toAsset(
    image=image,
    description='image_export_crstransform',
    assetId='projects/<project-name>/assets/<asset-name>',  # <> modify these
    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.toAsset(
    image=image,
    description='image_export_maxpixels',
    assetId='projects/<project-name>/assets/<asset-name>',  # <> modify these
    region=region,
    scale=30,
    crs='EPSG:5070',
    maxPixels=1e13
)
task.start()

# The default "pyramidingPolicy" is mean. If data are categorical,
# consider mode.
task = ee.batch.Export.image.toAsset(
    image=image.select('SR_B5'),
    description='image_export_pyramiding',
    assetId='projects/<project-name>/assets/<asset-name>',  # <> modify these
    region=region,
    scale=30,
    crs='EPSG:5070',
    pyramidingPolicy={'SR_B5': 'mode'}
)
task.start()