Export.image.toDrive

Bir resmi Drive'a raster olarak dışa aktarmak için toplu görev oluşturur. Görevler, Görevler sekmesinden başlatılabilir. "crsTransform", "scale" ve "dimensions" birbirini dışlar.

Kullanım	İadeler
Export.image.toDrive(image, description, folder, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)

Bağımsız Değişken	Tür	Ayrıntılar
image	Resim	Dışa aktarılacak resim.
description	Dize, isteğe bağlı	Görevin kullanıcılar tarafından okunabilecek adı. Harf, rakam, -, _ içerebilir (boşluk içermez). Varsayılan olarak "myExportImageTask" kullanılır.
folder	Dize, isteğe bağlı	Dışa aktarılan dosyanın bulunacağı Google Drive klasörü. Not: (a) Klasör adı herhangi bir düzeyde varsa çıkış bu klasöre yazılır, (b) klasör adları yineleniyorsa çıkış en son değiştirilen klasöre yazılır, (c) klasör adı yoksa kökte yeni bir klasör oluşturulur ve (d) ayırıcı içeren klasör adları (ör. "path/to/file") sistem yolları olarak değil, değişmez dizeler olarak yorumlanır. Varsayılan olarak Drive kökü kullanılır.
fileNamePrefix	Dize, isteğe bağlı	Dosya adı ön eki. Harf, rakam, -, _ içerebilir (boşluk içermez). Varsayılan olarak açıklama kullanılır.
dimensions	Number|String, isteğe bağlı	Dışa aktarılan resim için kullanılacak boyutlar. Maksimum boyut olarak tek bir pozitif tam sayı veya "GENİŞLİKxYÜKSEKLİK" değerini alır. Burada GENİŞLİK ve YÜKSEKLİK değerleri pozitif tam sayılardır.
region	Geometry.LinearRing|Geometry.Polygon|String, isteğe bağlı	Dışa aktarılacak bölgeyi temsil eden bir LinearRing, Polygon veya koordinatlar. Bunlar, Geometri nesneleri veya dize olarak serileştirilmiş koordinatlar şeklinde belirtilebilir.
scale	Numara, isteğe bağlı	Piksel başına metre cinsinden çözünürlük. Varsayılan olarak 1.000 değerine ayarlanır.
crs	Dize, isteğe bağlı	Dışa aktarılan görüntü için kullanılacak CRS.
crsTransform	List<Number>|String, isteğe bağlı	Dışa aktarılan resim için kullanılacak afin dönüşümü. "crs" tanımlanmalıdır.
maxPixels	Numara, isteğe bağlı	Dışa aktarma işlemindeki piksel sayısını sınırlayın. Varsayılan olarak, dışa aktarma işlemi 1e8 pikseli aşarsa hata görürsünüz. Bu değeri açıkça ayarlamak, bu sınırı yükseltmenize veya düşürmenize olanak tanır.
shardSize	Numara, isteğe bağlı	Bu resmin hesaplanacağı döşemelerin piksel cinsinden boyutu. Varsayılan olarak 256 değerine ayarlanır.
fileDimensions	List<Number>|Number, isteğe bağlı	Resim tek bir dosyaya sığmayacak kadar büyükse her resim dosyasının piksel cinsinden boyutları. Kare şekli belirtmek için tek bir sayı veya (genişlik, yükseklik) belirtmek için iki boyutlu bir dizi belirtebilir. Resmin, genel resim boyutlarına göre kırpılacağını unutmayın. Must be a multiple of shardSize.
skipEmptyTiles	Boole değeri, isteğe bağlı	Doğruysa boş (yani tamamen maskelenmiş) resim döşemelerini yazmayı atlayın. Varsayılan olarak false değerine ayarlanır. Yalnızca GeoTIFF dışa aktarma işlemlerinde desteklenir.
fileFormat	Dize, isteğe bağlı	Resmin dışa aktarıldığı dize dosya biçimi. Şu anda yalnızca "GeoTIFF" ve "TFRecord" desteklenmektedir. Varsayılan olarak "GeoTIFF" kullanılır.
formatOptions	ImageExportFormatConfig, isteğe bağlı	Biçime özel seçenekler için dize anahtarlarının sözlüğü. "GeoTIFF" için: "cloudOptimized" (boolean), "noData" (float). "TFRecord" için: https://developers.google.com/earth-engine/guides/tfrecord#formatoptions adresine bakın.
priority	Numara, isteğe bağlı	Görev önceliği Daha yüksek önceliğe sahip görevler daha erken planlanır. 0 ile 9999 arasında bir tam sayı olmalıdır. Varsayılan olarak 100 değerine ayarlanır.

Örnekler

Kod Düzenleyici (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 kurulumu

Python API'si ve etkileşimli geliştirme için geemap kullanımı hakkında bilgi edinmek üzere Python Ortamı sayfasına bakın.

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()