Wprowadzamy w Earth Engine poziomy limitów niekomercyjnych, aby chronić współdzielone zasoby obliczeniowe i zapewnić niezawodną wydajność dla wszystkich. Projekty niekomercyjne domyślnie korzystają z poziomu Społeczność, ale w każdej chwili możesz zmienić poziom projektu.

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

Export.image.toCloudStorage

Tworzy zadanie wsadowe eksportowania obrazu jako rastra do Google Cloud Storage. Zadania można uruchamiać na karcie Zadania.

Właściwości „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 (opcjonalnie)	Zrozumiała dla człowieka nazwa zadania. Domyślna wartość to „myExportImageTask”.
`bucket`	Ciąg znaków (opcjonalnie)	Zasobnik docelowy Cloud Storage.
`fileNamePrefix`	Ciąg znaków (opcjonalnie)	Ciąg znaków używany jako prefiks danych wyjściowych. Końcowy znak „/” wskazuje ścieżkę. Domyślna wartość to opis zadania.
`dimensions`	Liczba\|Ciąg znaków (opcjonalnie)	Wymiary, które mają być używane w przypadku eksportowanego obrazu. Można podać pojedynczą dodatnią liczbę całkowitą jako maksymalny wymiar lub „SZEROKOŚĆxWYSOKOŚĆ”, gdzie SZEROKOŚĆ i WYSOKOŚĆ to dodatnie liczby całkowite.
`region`	Geometry.LinearRing\|Geometry.Polygon\|Ciąg znaków (opcjonalnie)	LinearRing, wielokąt lub współrzędne reprezentujące region do wyeksportowania. Można je określić jako obiekty Geometry lub współrzędne serializowane jako ciąg znaków.
`scale`	Liczba (opcjonalnie)	Rozdzielczość w metrach na piksel. Domyślna wartość to 1000.
`crs`	Ciąg znaków (opcjonalnie)	Układ współrzędnych, który ma być używany w przypadku eksportowanego obrazu.
`crsTransform`	Lista[Liczba]\|Ciąg znaków (opcjonalnie)	Transformacja afiniczna, która ma być używana w przypadku eksportowanego obrazu. Wymaga zdefiniowania właściwości „crs”.
`maxPixels`	Liczba (opcjonalnie)	Ogranicz liczbę pikseli w eksporcie. Domyślnie, jeśli eksport przekroczy 1e8 pikseli, zobaczysz komunikat o błędzie. Ustawienie tej wartości pozwala zwiększyć lub zmniejszyć ten limit.
`shardSize`	Liczba (opcjonalnie)	Rozmiar w pikselach kafelków, w których będzie obliczany ten obraz. Domyślna wartość to 256.
`fileDimensions`	Lista[Liczba]\|Liczba (opcjonalnie)	Wymiary w pikselach każdego pliku graficznego, jeśli obraz jest zbyt duży, aby zmieścić się w jednym pliku. Możesz podać pojedynczą liczbę, aby wskazać kwadratowy kształt, lub tablicę 2 wymiarów, aby wskazać (szerokość, wysokość). Pamiętaj, że obraz nadal będzie przycinany do ogólnych wymiarów obrazu. Wartość musi być wielokrotnością wartości shardSize.
`skipEmptyTiles`	Wartość logiczna (opcjonalnie)	Jeśli wartość to true, pomiń zapisywanie pustych (czyli całkowicie zamaskowanych) kafelków obrazu. Wartość domyślna to fałsz. Obsługiwane tylko w przypadku eksportu GeoTIFF.
`fileFormat`	Ciąg znaków (opcjonalnie)	Format pliku, do którego eksportowany jest obraz. Obecnie obsługiwane są tylko formaty „GeoTIFF” i „TFRecord”. Domyślny format to „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”: https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
`priority`	Liczba (opcjonalnie)	Priorytet zadania w projekcie. Zadania o wyższym priorytecie są planowane wcześniej. Wartość 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()

Export.image.toCloudStorage Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Przykłady

Edytor kodu (JavaScript)

Colab (Python)

Export.image.toCloudStorage