Export.image.toCloudStorage

Cria uma tarefa em lote para exportar uma imagem como um raster para o Google Cloud Storage. As tarefas podem ser iniciadas na guia "Tarefas".

"crsTransform", "scale" e "dimensions" são mutuamente exclusivos.

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

Argumento	Tipo	Detalhes
image	Imagem	A imagem a ser exportada.
description	String, opcional	Um nome legível da tarefa. O padrão é "myExportImageTask".
bucket	String, opcional	O bucket de destino do Cloud Storage.
fileNamePrefix	String, opcional	A string usada como prefixo da saída. Uma barra final "/" indica um caminho. O padrão é a descrição da tarefa.
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.
fileDimensions	List[Number]|Number, opcional	As dimensões em pixels de cada arquivo de imagem, se a imagem for muito grande para caber em um único arquivo. Pode especificar um único número para indicar um formato quadrado ou uma matriz de duas dimensões para indicar (largura, altura). A imagem ainda será cortada de acordo com as dimensões gerais. Precisa ser um múltiplo de "shardSize".
skipEmptyTiles	Booleano, opcional	Se for verdadeiro, não grava blocos de imagens vazios (ou seja, totalmente mascarados). O padrão é "falso". Só é compatível com exportações GeoTIFF.
fileFormat	String, opcional	O formato do arquivo de string para o qual a imagem é exportada. No momento, apenas "GeoTIFF" e "TFRecord" são aceitos. O padrão é "GeoTIFF".
formatOptions	ImageExportFormatConfig, opcional	Um dicionário de chaves de string para opções específicas do formato. Para "GeoTIFF": "cloudOptimized" (booleano), "noData" (ponto flutuante). Para "TFRecord": consulte https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
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.

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.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
  }
});

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