Export.image.toDrive

יוצר משימה להעברת קבוצת נתונים לייצוא תמונה כרסטר ל-Drive. אפשר להתחיל משימות מהכרטיסייה 'משימות'. המאפיינים 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	מספר|מחרוזת, אופציונלי	המידות של התמונה המיוצאת. הפונקציה מקבלת מספר שלם חיובי יחיד כמימד המקסימלי, או את הערך 'רוחבXגובה', כאשר רוחב וגובה הם מספרים שלמים חיוביים.
region	‫Geometry.LinearRing|Geometry.Polygon|String, אופציונלי	‫LinearRing,‏ Polygon או קואורדינטות שמייצגות את האזור לייצוא. אפשר לציין אותם כאובייקטים של גיאומטריה או כקואורדינטות שסודרו כמחרוזת.
scale	מספר, אופציונלי	הרזולוציה במטרים לכל פיקסל. ברירת המחדל היא 1,000.
crs	מחרוזת, אופציונלי	מערכת CRS לשימוש בתמונה המיוצאת.
crsTransform	‫List[Number]|String, אופציונלי	טרנספורמציה אפינית לשימוש בתמונה המיוצאת. נדרשת הגדרה של 'מערכת קואורדינטות'.
maxPixels	מספר, אופציונלי	הגבלת מספר הפיקסלים בייצוא. כברירת מחדל, תוצג שגיאה אם הייצוא יחרוג מ-1e8 פיקסלים. הגדרה מפורשת של הערך הזה מאפשרת להגדיל או להקטין את המגבלה.
shardSize	מספר, אופציונלי	הגודל בפיקסלים של המשבצות שבהן התמונה הזו תחושב. ברירת המחדל היא 256.
fileDimensions	‫List[Number]|Number, אופציונלי	המידות בפיקסלים של כל קובץ תמונה, אם התמונה גדולה מדי ולא נכנסת לקובץ אחד. אפשר לציין מספר יחיד כדי לציין צורה ריבועית, או מערך של שני ממדים כדי לציין (רוחב,גובה). חשוב לזכור שהתמונה עדיין תיחתך בהתאם לממדים הכוללים של התמונה. חייב להיות כפולה של shardSize.
skipEmptyTiles	בוליאני, אופציונלי	אם הערך הוא True, המערכת מדלגת על כתיבה של אריחי תמונה ריקים (כלומר, מוסתרים לחלוטין). ברירת המחדל היא False. האפשרות הזו נתמכת רק בייצוא של GeoTIFF.
fileFormat	מחרוזת, אופציונלי	פורמט קובץ המחרוזות שאליו התמונה מיוצאת. כרגע יש תמיכה רק ב-GeoTIFF וב-TFRecord. ברירת המחדל היא GeoTIFF.
formatOptions	‫ImageExportFormatConfig, אופציונלי	מילון של מפתחות מחרוזת לאפשרויות ספציפיות לפורמט. ‫ 'GeoTIFF':‏ 'cloudOptimized' (בוליאני),‏ 'noData' (מספר נקודה צפה). ‫TFRecord: מידע נוסף זמין בכתובת https://developers.google.com/earth-engine/guides/tfrecord#formatoptions
priority	מספר, אופציונלי	רמת העדיפות של המשימה בפרויקט. משימות בעדיפות גבוהה יותר מתזמנים מוקדם יותר. חייב להיות מספר שלם בין 0 ל-9999. ברירת המחדל היא 100.

דוגמאות

Code Editor (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 API ועל השימוש ב-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()