Export.image.toCloudStorage

تنشئ هذه الطريقة مهمة دفعية لتصدير صورة كصورة نقطية إلى Google Cloud Storage. يمكن بدء المهام من علامة التبويب "مهام Google".

تستبعد "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	Number|String, optional	الأبعاد التي سيتم استخدامها للصورة التي تم تصديرها يجب إدخال عدد صحيح موجب واحد كحد أقصى للبعد أو "العرضxالارتفاع"، حيث يكون كل من العرض والارتفاع عددًا صحيحًا موجبًا.
region	‫Geometry.LinearRing|Geometry.Polygon|String، اختياري	تمثّل هذه السمة LinearRing أو Polygon أو الإحداثيات التي تمثّل المنطقة المطلوب تصديرها. يمكن تحديدها كعناصر هندسية أو إحداثيات مسلسلة كسلسلة.
scale	رقم، اختياري	درجة الدقة بالمتر لكل بكسل القيمة التلقائية هي 1000.
crs	سلسلة، اختيارية	نظام الإحداثيات المرجعية الذي سيتم استخدامه للصورة التي تم تصديرها.
crsTransform	List[Number]|String, optional	تحويل أفيني لاستخدامه في الصورة التي تم تصديرها يتطلّب تحديد "crs".
maxPixels	رقم، اختياري	تقييد عدد وحدات البكسل في عملية التصدير بشكلٍ تلقائي، سيظهر لك خطأ إذا تجاوزت عملية التصدير 100 مليون بكسل. يسمح ضبط هذه القيمة بشكلٍ صريح برفع هذا الحدّ أو خفضه.
shardSize	رقم، اختياري	حجم المربّعات بالبكسل التي سيتم احتساب هذه الصورة فيها القيمة التلقائية هي 256.
fileDimensions	List[Number]|Number, optional	تمثّل هذه السمة أبعاد كل ملف صورة بالبكسل، إذا كانت الصورة كبيرة جدًا بحيث لا يمكن وضعها في ملف واحد. يمكن تحديد رقم واحد للإشارة إلى شكل مربّع، أو مصفوفة ذات سمتَين للإشارة إلى (العرض، الارتفاع). يُرجى العِلم أنّه سيتمّ قصّ الصورة لتناسب أبعاد الصورة الإجمالية. يجب أن يكون مضاعفًا لـ shardSize.
skipEmptyTiles	قيمة منطقية، اختيارية	إذا كانت القيمة true، سيتم تخطّي كتابة مربّعات الصور الفارغة (أي التي تم إخفاء جميع وحداتها). القيمة التلقائية هي "خطأ". لا تتوفّر إلا عند تصدير ملفات GeoTIFF.
fileFormat	سلسلة، اختيارية	تنسيق ملف السلسلة الذي يتم تصدير الصورة إليه. لا يتوفّر حاليًا سوى التنسيقَين GeoTIFF وTFRecord، ويتم ضبط GeoTIFF تلقائيًا.
formatOptions	ImageExportFormatConfig، اختياري	قاموس لمفاتيح السلسلة وخيارات خاصة بالتنسيق بالنسبة إلى GeoTIFF: cloudOptimized (قيمة منطقية)، noData (عدد عشري) بالنسبة إلى TFRecord، يُرجى الاطّلاع على https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priority	رقم، اختياري	أولوية المهمة ضمن المشروع يتم تحديد موعد للمهام ذات الأولوية الأعلى في وقت أقرب. يجب أن تكون القيمة عددًا صحيحًا يتراوح بين 0 و9999. القيمة التلقائية هي 100.

أمثلة

أداة تعديل الرموز (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
  }
});

إعداد Python

راجِع صفحة بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام geemap للتطوير التفاعلي.

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