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	سلسلة، اختياري	نظام الإحداثيات المرجعي (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.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
  }
});

إعداد 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:
# 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()