Export.image.toCloudStorage

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

لا يمكن استخدام "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|String, optional	تمثّل هذه السمة LinearRing أو Polygon أو إحداثيات المنطقة المطلوب تصديرها. يمكن تحديد هذه القيم ككائنات Geometry أو إحداثيات يتم تسلسلها كسلسلة.
scale	رقم، اختياري	الدقة بالمتر لكل بكسل القيمة التلقائية هي 1000.
crs	سلسلة، اختيارية	نظام الإحداثيات المطلوب استخدامه للصورة التي تم تصديرها
crsTransform	List[Number]|String, optional	التحويل الأفيني المطلوب استخدامه للصورة التي تم تصديرها يجب تحديد "crs".
maxPixels	رقم، اختياري	الحدّ من عدد البكسل في عملية التصدير تظهر لك تلقائيًا رسالة خطأ إذا تجاوزت عملية التصدير 1e8 بكسل. يسمح لك ضبط هذه القيمة بشكل صريح برفع هذا الحدّ أو خفضه.
shardSize	رقم، اختياري	حجم مربّعات الصورة بالبكسل التي سيتم احتساب هذه الصورة فيها القيمة التلقائية هي 256.
fileDimensions	List[Number]|Number, optional	أبعاد كل ملف صورة بالبكسل، إذا كانت الصورة كبيرة جدًا بحيث لا يمكن وضعها في ملف واحد يمكن تحديد رقم واحد للإشارة إلى شكل مربّع، أو مصفوفة من بُعدَين للإشارة إلى (العرض، الارتفاع). يُرجى العِلم أنّه سيتم قص الصورة وفقًا لأبعاد الصورة الإجمالية. يجب أن تكون القيمة من مضاعفات shardSize.
skipEmptyTiles	قيمة منطقية، اختيارية	إذا كانت القيمة "صحيح"، يتم تخطّي كتابة مربّعات الصور الفارغة (أي المموّهة بالكامل). القيمة التلقائية هي "خطأ". لا تتوفّر هذه الميزة إلا لعمليات تصدير 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()