Export.image.toCloudStorage

Membuat tugas batch untuk mengekspor Gambar sebagai raster ke Google Cloud Storage. Tugas dapat dimulai dari tab Tasks.

"crsTransform", "scale", dan "dimensions" tidak dapat digunakan secara bersamaan.

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

Argumen	Jenis	Detail
image	Gambar	Gambar yang akan diekspor.
description	String, opsional	Nama tugas yang dapat dibaca manusia. Default-nya adalah "myExportImageTask".
bucket	String, opsional	Bucket tujuan Cloud Storage.
fileNamePrefix	String, opsional	String yang digunakan sebagai awalan output. "/" di akhir menunjukkan jalur. Default-nya adalah deskripsi tugas.
dimensions	Number|String, opsional	Dimensi yang akan digunakan untuk gambar yang diekspor. Mengambil satu bilangan bulat positif sebagai dimensi maksimum atau "LEBARxTINGGI" dengan LEBAR dan TINGGI masing-masing adalah bilangan bulat positif.
region	Geometry.LinearRing|Geometry.Polygon|String, opsional	LinearRing, Poligon, atau koordinat yang merepresentasikan wilayah yang akan diekspor. Objek ini dapat ditentukan sebagai objek Geometri atau koordinat yang diserialisasi sebagai string.
scale	Nomor, opsional	Resolusi dalam meter per piksel. Setelan defaultnya adalah 1.000.
crs	String, opsional	CRS yang akan digunakan untuk gambar yang diekspor.
crsTransform	List[Number]|String, opsional	Transformasi affine yang akan digunakan untuk gambar yang diekspor. Memerlukan "crs" untuk ditentukan.
maxPixels	Nomor, opsional	Membatasi jumlah piksel dalam ekspor. Secara default, Anda akan melihat error jika ekspor melebihi 1e8 piksel. Dengan menetapkan nilai ini secara eksplisit, pengguna dapat menaikkan atau menurunkan batas ini.
shardSize	Nomor, opsional	Ukuran dalam piksel petak tempat gambar ini akan dihitung. Nilai defaultnya adalah 256.
fileDimensions	List[Number]|Number, opsional	Dimensi dalam piksel setiap file gambar, jika gambar terlalu besar untuk dimuat dalam satu file. Dapat menentukan satu angka untuk menunjukkan bentuk persegi, atau array dua dimensi untuk menunjukkan (lebar,tinggi). Perhatikan bahwa gambar akan tetap dipangkas sesuai dimensi gambar keseluruhan. Harus kelipatan shardSize.
skipEmptyTiles	Boolean, opsional	Jika benar, lewati penulisan petak gambar kosong (yaitu, yang sepenuhnya tertutup). Nilai defaultnya adalah false (salah). Hanya didukung pada ekspor GeoTIFF.
fileFormat	String, opsional	Format file string tempat gambar diekspor. Saat ini hanya 'GeoTIFF' dan 'TFRecord' yang didukung, defaultnya adalah 'GeoTIFF'.
formatOptions	ImageExportFormatConfig, opsional	Kamus kunci string ke opsi khusus format. Untuk 'GeoTIFF': 'cloudOptimized' (Boolean), 'noData' (float). Untuk 'TFRecord': lihat https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priority	Nomor, opsional	Prioritas tugas dalam project. Tugas dengan prioritas lebih tinggi dijadwalkan lebih awal. Harus berupa bilangan bulat antara 0 dan 9999. Setelan defaultnya adalah 100.

Contoh

Editor Kode (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
  }
});

Penyiapan Python

Baca halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

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