Earth Engine đã giới thiệu các bậc hạn mức phi thương mại để bảo vệ các tài nguyên điện toán dùng chung và đảm bảo hiệu suất đáng tin cậy cho mọi người. Các dự án phi thương mại sử dụng Cấp cộng đồng theo mặc định, mặc dù bạn có thể thay đổi cấp của dự án bất cứ lúc nào.

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

Export.image.toCloudStorage

Tạo một tác vụ hàng loạt để xuất Hình ảnh dưới dạng một hình ảnh raster sang Google Cloud Storage. Bạn có thể bắt đầu các việc cần làm từ thẻ Tasks.

"crsTransform", "scale" và "dimensions" là các thuộc tính loại trừ lẫn nhau.

Cách sử dụng	Giá trị trả về
`Export.image.toCloudStorage(image, description, bucket, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)`

Đối số	Loại	Thông tin chi tiết
`image`	Hình ảnh	Hình ảnh cần xuất.
`description`	Chuỗi, không bắt buộc	Tên dễ đọc của việc cần làm. Giá trị mặc định là "myExportImageTask".
`bucket`	Chuỗi, không bắt buộc	Bộ chứa đích của Cloud Storage.
`fileNamePrefix`	Chuỗi, không bắt buộc	Chuỗi được dùng làm tiền tố của đầu ra. Dấu "/" ở cuối cho biết một đường dẫn. Mặc định là nội dung mô tả của việc cần làm.
`dimensions`	Number\|String, không bắt buộc	Kích thước dùng cho hình ảnh được xuất. Nhận một số nguyên dương duy nhất làm kích thước tối đa hoặc "WIDTHxHEIGHT", trong đó WIDTH và HEIGHT đều là số nguyên dương.
`region`	Geometry.LinearRing\|Geometry.Polygon\|String, không bắt buộc	LinearRing, Polygon hoặc toạ độ đại diện cho khu vực cần xuất. Bạn có thể chỉ định các đối tượng này dưới dạng đối tượng Hình học hoặc toạ độ được chuyển đổi tuần tự thành một chuỗi.
`scale`	Số, không bắt buộc	Độ phân giải tính bằng mét trên mỗi pixel. Giá trị mặc định là 1000.
`crs`	Chuỗi, không bắt buộc	CRS sẽ dùng cho hình ảnh được xuất.
`crsTransform`	List[Number]\|String, không bắt buộc	Phép biến đổi á-phin dùng cho hình ảnh được xuất. Yêu cầu bạn phải xác định "crs".
`maxPixels`	Số, không bắt buộc	Hạn chế số lượng pixel trong tệp xuất. Theo mặc định, bạn sẽ thấy lỗi nếu tệp xuất vượt quá 100 triệu pixel. Việc đặt giá trị này một cách rõ ràng cho phép bạn tăng hoặc giảm giới hạn này.
`shardSize`	Số, không bắt buộc	Kích thước tính bằng pixel của các ô mà hình ảnh này sẽ được tính toán. Giá trị mặc định là 256.
`fileDimensions`	List[Number]\|Number, không bắt buộc	Kích thước (tính bằng pixel) của mỗi tệp hình ảnh, nếu hình ảnh quá lớn để vừa trong một tệp. Có thể chỉ định một số duy nhất để cho biết hình vuông hoặc một mảng gồm 2 chiều để cho biết (chiều rộng, chiều cao). Xin lưu ý rằng hình ảnh vẫn sẽ bị cắt theo kích thước tổng thể của hình ảnh. Phải là bội số của shardSize.
`skipEmptyTiles`	Boolean, không bắt buộc	Nếu đúng, hãy bỏ qua việc ghi các ô hình ảnh trống (tức là được che hoàn toàn). Mặc định là sai. Chỉ được hỗ trợ trên các tệp xuất GeoTIFF.
`fileFormat`	Chuỗi, không bắt buộc	Định dạng tệp chuỗi mà hình ảnh được xuất sang. Hiện tại, chỉ có "GeoTIFF" và "TFRecord" được hỗ trợ, mặc định là "GeoTIFF".
`formatOptions`	ImageExportFormatConfig (không bắt buộc)	Từ điển khoá chuỗi cho các lựa chọn dành riêng cho định dạng. Đối với "GeoTIFF": "cloudOptimized" (Boolean), "noData" (float). Đối với "TFRecord": xem https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
`priority`	Số, không bắt buộc	Mức độ ưu tiên của nhiệm vụ trong dự án. Các nhiệm vụ có mức độ ưu tiên cao hơn sẽ được lên lịch sớm hơn. Phải là một số nguyên từ 0 đến 9999. Giá trị mặc định là 100.

Ví dụ

Trình chỉnh sửa mã (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
  }
});

Thiết lập Python

Hãy xem trang Môi trường Python để biết thông tin về Python API và cách sử dụng geemap cho quá trình phát triển có tính tương tác.

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 Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Ví dụ

Trình chỉnh sửa mã (JavaScript)

Colab (Python)

Export.image.toCloudStorage