O Earth Engine introduziu níveis de cota não comercial para proteger recursos de computação compartilhados e garantir um desempenho confiável para todo mundo. Os projetos não comerciais usam o nível da comunidade por padrão, mas é possível mudar o nível de um projeto a qualquer momento.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 "/" no 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 "LARGURAxALTURA", em que LARGURA e ALTURA são números inteiros positivos.
`region`	Geometry.LinearRing\|Geometry.Polygon\|String, opcional	Um LinearRing, um polígono 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, pule a gravação de 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" (float). 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()

Export.image.toCloudStorage Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Exemplos

Editor de código (JavaScript)

Colab (Python)

Export.image.toCloudStorage