Export.image.toAsset

Cria uma tarefa em lote para exportar uma imagem como um raster para um recurso do Earth Engine. As tarefas podem ser iniciadas na guia "Tarefas".

Uso	Retorna
Export.image.toAsset(image, description, assetId, pyramidingPolicy, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, priority, overwrite)

Argumento	Tipo	Detalhes
image	Imagem	A imagem a ser exportada.
description	String, opcional	Um nome legível da tarefa. O padrão é "myExportImageTask".
assetId	String, opcional	O ID do recurso de destino.
pyramidingPolicy	Objeto, opcional	A política de piramidação a ser aplicada a cada banda na imagem, com chave pelo nome da banda. Os valores precisam ser um destes: média, amostra, mínimo, máximo ou modo. O padrão é "mean". Uma chave especial, ".default", pode ser usada para mudar o padrão de todas as bandas.
dimensions	Número|String, opcional	As dimensões a serem usadas para a imagem exportada. Aceita um único número inteiro positivo como a dimensão máxima ou "WIDTHxHEIGHT", em que WIDTH e HEIGHT são números inteiros positivos.
region	Geometry.LinearRing|Geometry.Polygon|String, opcional	Um LinearRing, Polygon ou coordenadas que representam a região a ser exportada. Eles podem ser especificados como objetos de geometria ou coordenadas serializadas como uma string.
scale	Número, opcional	Resolução em metros por pixel. O valor padrão é 1.000.
crs	String, opcional	SRC a ser usado para a imagem exportada.
crsTransform	List[Number]|String, opcional	Transformação afim a ser usada para a imagem exportada. Requer que "crs" seja definido.
maxPixels	Número, opcional	Restrinja o número de pixels na exportação. Por padrão, um erro vai aparecer se a exportação exceder 1e8 pixels. Definir esse valor explicitamente permite aumentar ou diminuir esse limite.
shardSize	Número, opcional	Tamanho em pixels dos blocos em que essa imagem será calculada. O padrão é 256.
priority	Número, opcional	A prioridade da tarefa no projeto. As tarefas de maior prioridade são programadas antes. O valor precisa ser um número inteiro entre 0 e 9999. O padrão é 100.
overwrite	Booleano, opcional	Se o recurso vai ser substituído caso já exista. O padrão é "falso".

Exemplos

Editor de código (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'}
});

Configuração do Python

Consulte a página Ambiente Python (em inglês) para informações sobre a API Python e como usar geemap para desenvolvimento interativo.

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