Export.image.toDrive

تنشئ هذه الطريقة مهمة دفعية لتصدير صورة كصورة نقطية إلى Drive. يمكن بدء المهام من علامة التبويب "مهام Google". تستبعد "crsTransform" و"scale" و "dimensions" بعضها البعض.

الاستخدام	المرتجعات
Export.image.toDrive(image, description, folder, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)

الوسيطة	النوع	التفاصيل
image	صورة	الصورة المطلوب تصديرها
description	سلسلة، اختيارية	اسم المهمة الذي يمكن للمستخدم قراءته يمكن أن يحتوي على أحرف وأرقام و- و_ (بدون مسافات). القيمة التلقائية هي "myExportImageTask".
folder	سلسلة، اختيارية	مجلد Google Drive الذي سيتم تخزين عملية التصدير فيه ملاحظة: (أ) إذا كان اسم المجلد متوفّرًا في أي مستوى، تتم كتابة الناتج فيه، (ب) إذا كانت أسماء المجلدات مكرّرة، تتم كتابة الناتج في المجلد الذي تم تعديله مؤخرًا، (ج) إذا لم يكن اسم المجلد متوفّرًا، سيتم إنشاء مجلد جديد في الجذر، (د) يتم تفسير أسماء المجلدات التي تتضمّن فواصل (مثل "path/to/file") كسلاسل حرفية، وليس كمسارات نظام. يتم تلقائيًا اختيار جذر Drive.
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.toDrive({
  image: image,
  description: 'image_export',
  folder: 'ee_demos',
  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.toDrive({
  image: image,
  description: 'image_export_crstransform',
  folder: 'ee_demos',
  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.toDrive({
  image: image,
  description: 'image_export_maxpixels',
  folder: 'ee_demos',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  maxPixels: 1e13
});

// Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
// parameter to true.
Export.image.toDrive({
  image: image,
  description: 'image_export_cog',
  folder: 'ee_demos',
  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',
  folder: 'ee_demos',
  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.toDrive(
    image=image,
    description='image_export',
    folder='ee_demos',
    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.toDrive(
    image=image,
    description='image_export_crstransform',
    folder='ee_demos',
    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.toDrive(
    image=image,
    description='image_export_maxpixels',
    folder='ee_demos',
    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.toDrive(
    image=image,
    description='image_export_cog',
    folder='ee_demos',
    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',
    folder='ee_demos',
    region=image.geometry(),  # full image bounds
    scale=2000,  # large scale for minimal demo
    crs='EPSG:5070',
    fileFormat='GeoTIFF',
    formatOptions={
        'noData': nodata_val
    }
)
task.start()