Export.image.toCloudStorage

یک وظیفه دسته‌ای برای خروجی گرفتن از یک تصویر به صورت رستر به فضای ذخیره‌سازی ابری گوگل ایجاد می‌کند. وظایف را می‌توان از برگه وظایف (Tasks) شروع کرد.

«crsTransform»، «scale» و «dimensions» متقابلاً منحصر به فرد هستند.

کاربرد	بازگشت‌ها
Export.image.toCloudStorage(image, description , bucket , fileNamePrefix , dimensions , region , scale , crs , crsTransform , maxPixels , shardSize , fileDimensions , skipEmptyTiles , fileFormat , formatOptions , priority )

استدلال	نوع	جزئیات
image	تصویر	The image to export.
description	String, optional	نامی خوانا برای وظیفه. مقدار پیش‌فرض آن "myExportImageTask" است.
bucket	String, optional	The Cloud Storage destination bucket.
fileNamePrefix	رشته، اختیاری	رشته‌ای که به عنوان پیشوند خروجی استفاده می‌شود. علامت "/" در انتهای آن، مسیر را نشان می‌دهد. به طور پیش‌فرض، شرح وظیفه است.
dimensions	Number|String, optional	ابعادی که برای تصویر خروجی استفاده می‌شود. یا یک عدد صحیح مثبت را به عنوان حداکثر بعد در نظر می‌گیرد یا "عرض × ارتفاع" را انتخاب می‌کند که در آن عرض و ارتفاع هر کدام اعداد صحیح مثبت هستند.
region	هندسه.حلقه خطی|هندسه.چندضلعی|رشته، اختیاری	یک LinearRing، Polygon یا مختصاتی که نشان‌دهنده‌ی ناحیه‌ای برای خروجی گرفتن هستند. این موارد ممکن است به عنوان اشیاء Geometry یا مختصات سریالی شده به صورت یک رشته مشخص شوند.
scale	شماره، اختیاری	وضوح تصویر بر حسب متر بر پیکسل. پیش‌فرض ۱۰۰۰.
crs	رشته، اختیاری	CRS برای استفاده در تصویر خروجی.
crsTransform	List[Number]|String, optional	تبدیل آفین برای استفاده در تصویر خروجی. نیاز به تعریف "crs" دارد.
maxPixels	شماره، اختیاری	تعداد پیکسل‌های خروجی را محدود کنید. به طور پیش‌فرض، اگر خروجی از ۱ تا ۸ پیکسل بیشتر شود، خطایی مشاهده خواهید کرد. تنظیم این مقدار به صراحت به شما امکان می‌دهد این محدودیت را افزایش یا کاهش دهید.
shardSize	Number, optional	اندازه کاشی‌هایی که این تصویر در آنها محاسبه خواهد شد (به پیکسل). مقدار پیش‌فرض ۲۵۶ است.
fileDimensions	List[Number]|Number، اختیاری	ابعاد هر فایل تصویر بر حسب پیکسل، در صورتی که تصویر برای قرار گرفتن در یک فایل واحد خیلی بزرگ باشد. ممکن است یک عدد برای نشان دادن شکل مربع یا یک آرایه با دو بعد برای نشان دادن (عرض، ارتفاع) مشخص شود. توجه داشته باشید که تصویر همچنان به ابعاد کلی تصویر برش داده می‌شود. باید مضربی از shardSize باشد.
skipEmptyTiles	Boolean, optional	اگر درست باشد، از نوشتن کاشی‌های تصویر خالی (یعنی کاملاً ماسک‌شده) صرف‌نظر کنید. پیش‌فرض روی نادرست است. فقط در خروجی‌های GeoTIFF پشتیبانی می‌شود.
fileFormat	رشته، اختیاری	فرمت فایل رشته‌ای که تصویر به آن صادر می‌شود. در حال حاضر فقط 'GeoTIFF' و 'TFRecord' پشتیبانی می‌شوند، پیش‌فرض روی 'GeoTIFF' است.
formatOptions	پیکربندی فرمت خروجی تصویر، اختیاری	یک دیکشنری از کلیدهای رشته‌ای برای گزینه‌های خاص قالب. برای 'GeoTIFF': 'cloudOptimized' (Boolean)، 'noData' (float). برای 'TFRecord': به https://developers.google.com/earth-engine/guides/tfrecord#formatoptions مراجعه کنید.
priority	شماره، اختیاری	اولویت وظیفه در پروژه. وظایف با اولویت بالاتر زودتر زمان‌بندی می‌شوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. پیش‌فرض ۱۰۰ است.

مثال‌ها

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

// 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
  }
});

تنظیمات پایتون

برای اطلاعات بیشتر در مورد 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:
# 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()