Export.image.toCloudStorage

Tworzy zadanie wsadowe, które eksportuje obraz jako raster do Google Cloud Storage. Zadania można rozpocząć na karcie Zadania.

Parametry „crsTransform”, „scale” i „dimensions” wykluczają się wzajemnie.

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

Argument	Typ	Szczegóły
image	Obraz	Obraz do wyeksportowania.
description	Ciąg znaków, opcjonalny	Zrozumiała dla człowieka nazwa zadania. Domyślna wartość to „myExportImageTask”.
bucket	Ciąg znaków, opcjonalny	Zasobnik docelowy Cloud Storage.
fileNamePrefix	Ciąg znaków, opcjonalny	Ciąg znaków używany jako prefiks danych wyjściowych. Końcowy znak „/” oznacza ścieżkę. Domyślnie jest to opis zadania.
dimensions	Number|String, opcjonalnie	Wymiary, które mają być użyte w przypadku eksportowanego obrazu. Przyjmuje pojedynczą dodatnią liczbę całkowitą jako maksymalny wymiar lub ciąg znaków „WIDTHxHEIGHT”, gdzie WIDTH i HEIGHT to dodatnie liczby całkowite.
region	Geometry.LinearRing|Geometry.Polygon|String, opcjonalnie	LinearRing, Polygon lub współrzędne reprezentujące region do wyeksportowania. Mogą to być obiekty Geometry lub współrzędne zserializowane jako ciąg znaków.
scale	Numer, opcjonalny	Rozdzielczość w metrach na piksel. Domyślna wartość to 1000.
crs	Ciąg znaków, opcjonalny	Układ współrzędnych, który ma być używany w eksportowanym obrazie.
crsTransform	List[Number]|String, opcjonalnie	Przekształcenie afiniczne, które ma zostać użyte w przypadku eksportowanego obrazu. Wymaga zdefiniowania parametru „crs”.
maxPixels	Numer, opcjonalny	Ogranicz liczbę pikseli w eksportowanym pliku. Domyślnie, jeśli eksport przekroczy 1e8 pikseli, zobaczysz błąd. Jawne ustawienie tej wartości pozwala zwiększyć lub zmniejszyć ten limit.
shardSize	Numer, opcjonalny	Rozmiar w pikselach kafelków, w których będzie obliczany ten obraz. Domyślna wartość to 256.
fileDimensions	List[Number]|Number, opcjonalnie	Wymiary w pikselach każdego pliku obrazu, jeśli obraz jest zbyt duży, aby zmieścić się w jednym pliku. Możesz podać jedną liczbę, aby wskazać kwadratowy kształt, lub tablicę dwóch wymiarów, aby wskazać (szerokość, wysokość). Pamiętaj, że obraz nadal będzie przycinany do ogólnych wymiarów obrazu. Musi być wielokrotnością wartości shardSize.
skipEmptyTiles	Wartość logiczna, opcjonalna	Jeśli ma wartość true, pomiń zapisywanie pustych (czyli w pełni zamaskowanych) kafelków obrazu. Wartość domyślna to fałsz. Obsługiwane tylko w przypadku eksportu do formatu GeoTIFF.
fileFormat	Ciąg znaków, opcjonalny	Format pliku tekstowego, do którego eksportowany jest obraz. Obecnie obsługiwane są tylko formaty „GeoTIFF” i „TFRecord”. Domyślnie używany jest format „GeoTIFF”.
formatOptions	ImageExportFormatConfig, opcjonalnie	Słownik kluczy ciągów znaków do opcji specyficznych dla formatu. W przypadku formatu „GeoTIFF”: „cloudOptimized” (wartość logiczna), „noData” (liczba zmiennoprzecinkowa). W przypadku formatu „TFRecord”: zobacz https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priority	Numer, opcjonalny	Priorytet zadania w projekcie. Zadania o wyższym priorytecie są planowane wcześniej. Musi być liczbą całkowitą z zakresu od 0 do 9999. Domyślna wartość to 100.

Przykłady

Edytor kodu (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
  }
});

Konfiguracja Pythona

Informacje o interfejsie API dla Pythona oraz o używaniu geemap do interaktywnego programowania znajdziesz na stronie środowiska 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()