Export.image.toCloudStorage

یک کار دسته‌ای ایجاد می‌کند تا یک تصویر را به‌صورت رستری به Google Cloud Storage صادر کند. کارها را می توان از برگه Tasks شروع کرد.

"crsTransform"، "scale"، و "dimensions" متقابل هستند.

استفاده	برمی گرداند
Export.image.toCloudStorage(image, description , bucket , fileNamePrefix , dimensions , region , scale , crs , crsTransform , maxPixels , shardSize , fileDimensions , skipEmptyTiles , fileFormat , formatOptions , priority )

استدلال	تایپ کنید	جزئیات
image	تصویر	تصویر برای صادرات
description	رشته، اختیاری	نام کار قابل خواندن برای انسان. پیش‌فرض «myExportImageTask» است.
bucket	رشته، اختیاری	سطل مقصد Cloud Storage.
fileNamePrefix	رشته، اختیاری	رشته ای که به عنوان پیشوند خروجی استفاده می شود. یک "/" انتهایی یک مسیر را نشان می دهد. پیش‌فرض‌های شرح کار.
dimensions	شماره|رشته، اختیاری	ابعاد مورد استفاده برای تصویر صادر شده یک عدد صحیح مثبت منفرد را به عنوان حداکثر بعد می گیرد یا "WIDTHxHEIGHT" که در آن WIDTH و HEIGHT هر کدام اعداد صحیح مثبت هستند.
region	Geometry.LinearRing|Geometry.Polygon|رشته، اختیاری	یک حلقه خطی، چند ضلعی یا مختصاتی که نماینده منطقه برای صادرات است. اینها ممکن است به عنوان اشیاء هندسه یا مختصات سریالی شده به عنوان یک رشته مشخص شوند.
scale	شماره، اختیاری	وضوح بر حسب متر بر پیکسل پیش فرض 1000 است.
crs	رشته، اختیاری	CRS برای استفاده از تصویر صادر شده.
crsTransform	List<Number>|رشته، اختیاری	برای استفاده از تصویر صادر شده، تبدیل را اضافه کنید. نیاز به تعریف "crs" دارد.
maxPixels	شماره، اختیاری	تعداد پیکسل ها را در صادرات محدود کنید. به‌طور پیش‌فرض، اگر خروجی بیش از 1e8 پیکسل باشد، با خطا مواجه می‌شوید. تنظیم این مقدار به صراحت به فرد امکان می دهد این حد را افزایش یا کاهش دهد.
shardSize	شماره، اختیاری	اندازه بر حسب پیکسل کاشی هایی که این تصویر در آنها محاسبه می شود. پیش فرض 256 است.
fileDimensions	List<Number>|شماره، اختیاری	ابعاد هر فایل تصویری بر حسب پیکسل، در صورتی که تصویر آنقدر بزرگ باشد که در یک فایل قرار نگیرد. ممکن است یک عدد برای نشان دادن یک شکل مربع یا آرایه ای از دو بعد برای نشان دادن (عرض، ارتفاع) مشخص کند. توجه داشته باشید که تصویر همچنان به ابعاد کلی تصویر بریده می شود. باید مضربی از shardSize باشد.
skipEmptyTiles	بولی، اختیاری	اگر درست است، از نوشتن کاشی های تصویر خالی (یعنی کاملاً ماسک شده) صرف نظر کنید. پیش فرض به نادرست. فقط در صادرات GeoTIFF پشتیبانی می شود.
fileFormat	رشته، اختیاری	فرمت فایل رشته ای که تصویر به آن صادر می شود. در حال حاضر فقط «GeoTIFF» و «TFRecord» پشتیبانی می‌شوند که پیش‌فرض «GeoTIFF» است.
formatOptions	ImageExportFormatConfig، اختیاری است	فرهنگ لغت کلیدهای رشته ای برای قالب بندی گزینه های خاص. برای "GeoTIFF": "cloudOptimized" (Boolean)، "noData" (float). برای "TFRecord": https://developers.google.com/earth-engine/guides/tfrecord#formatoptions را ببینید
priority	شماره، اختیاری	اولویت کار در پروژه. کارهای با اولویت بالاتر زودتر برنامه ریزی می شوند. باید یک عدد صحیح بین 0 و 9999 باشد. پیش فرض 100 است.

نمونه ها

ویرایشگر کد (جاوا اسکریپت)

// 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.toDrive({
  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
  }
});

راه اندازی پایتون

برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.

import ee
import geemap.core as geemap

کولب (پایتون)

# 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:
# print(image.projection().getInfo())
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.toDrive(
    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()