Export.image.toDrive

Drive में किसी इमेज को रेस्टर के तौर पर एक्सपोर्ट करने के लिए, एक बैच टास्क बनाता है. Tasks टैब से टास्क शुरू किए जा सकते हैं. "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 का वह फ़ोल्डर जिसमें एक्सपोर्ट की गई फ़ाइल सेव होगी. ध्यान दें: (a) अगर फ़ोल्डर का नाम किसी भी लेवल पर मौजूद है, तो आउटपुट उसमें लिखा जाता है, (b) अगर फ़ोल्डर के डुप्लीकेट नाम मौजूद हैं, तो आउटपुट हाल ही में बदले गए फ़ोल्डर में लिखा जाता है, (c) अगर फ़ोल्डर का नाम मौजूद नहीं है, तो रूट में एक नया फ़ोल्डर बनाया जाएगा, और (d) सेपरेटर वाले फ़ोल्डर के नाम (उदाहरण के लिए, 'path/to/file') को सिस्टम पाथ के बजाय लिटरल स्ट्रिंग के तौर पर समझा जाता है. डिफ़ॉल्ट रूप से, Drive के रूट पर सेट होता है.
fileNamePrefix	स्ट्रिंग, ज़रूरी नहीं	फ़ाइल के नाम का प्रीफ़िक्स. इसमें अक्षर, संख्याएं, -, _ (कोई स्पेस नहीं) शामिल हो सकते हैं. डिफ़ॉल्ट रूप से, ब्यौरा दिखता है.
dimensions	Number|String, optional	एक्सपोर्ट की गई इमेज के लिए इस्तेमाल किए जाने वाले डाइमेंशन. ज़्यादा से ज़्यादा डाइमेंशन के तौर पर, एक पॉज़िटिव पूर्णांक या "WIDTHxHEIGHT" लेता है. इसमें WIDTH और HEIGHT, दोनों पॉज़िटिव पूर्णांक होते हैं.
region	Geometry.LinearRing|Geometry.Polygon|String, ज़रूरी नहीं	एक्सपोर्ट किए जाने वाले इलाके को दिखाने वाला लीनियर रिंग, पॉलीगॉन या निर्देशांक. इन्हें ज्यामिति ऑब्जेक्ट या स्ट्रिंग के तौर पर सीरियल किए गए निर्देशांक के तौर पर बताया जा सकता है.
scale	नंबर, ज़रूरी नहीं	हर पिक्सल के हिसाब से मीटर में रिज़ॉल्यूशन. डिफ़ॉल्ट रूप से, यह वैल्यू 1,000 होती है.
crs	स्ट्रिंग, ज़रूरी नहीं	एक्सपोर्ट की गई इमेज के लिए इस्तेमाल किया जाने वाला सीआरएस.
crsTransform	List<Number>|String, ज़रूरी नहीं	एक्सपोर्ट की गई इमेज के लिए इस्तेमाल किया जाने वाला ऐफ़ाइन ट्रांसफ़ॉर्म. "crs" की वैल्यू तय होनी चाहिए.
maxPixels	नंबर, ज़रूरी नहीं	एक्सपोर्ट में पिक्सल की संख्या सीमित करें. अगर एक्सपोर्ट किए जाने वाले डेटा का साइज़ 10 करोड़ पिक्सल से ज़्यादा है, तो आपको डिफ़ॉल्ट रूप से गड़बड़ी का मैसेज दिखेगा. इस वैल्यू को साफ़ तौर पर सेट करने से, इस सीमा को बढ़ाया या घटाया जा सकता है.
shardSize	नंबर, ज़रूरी नहीं	उन टाइल का साइज़ पिक्सल में जिनमें इस इमेज का हिसाब लगाया जाएगा. डिफ़ॉल्ट रूप से, यह 256 पर सेट होती है.
fileDimensions	List<Number>|Number, ज़रूरी नहीं	अगर इमेज एक फ़ाइल में फ़िट नहीं हो पा रही है, तो हर इमेज फ़ाइल के डाइमेंशन पिक्सल में. स्क्वेयर आकार दिखाने के लिए, एक नंबर या चौड़ाई और ऊंचाई दिखाने के लिए,दो डाइमेंशन का ऐरे दिया जा सकता है. ध्यान दें कि इमेज को अब भी पूरे डाइमेंशन में काटा जाएगा. यह संख्या, 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.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 API के बारे में जानकारी पाने और इंटरैक्टिव डेवलपमेंट के लिए geemap का इस्तेमाल करने के लिए, Python एनवायरमेंट पेज देखें.

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:
# print(image.projection().getInfo())
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()