Export.image.toDrive

Создает пакетное задание для экспорта изображения в растровом формате на 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 Диска, в которую будет сохранен экспорт. Примечание: (a) если имя папки существует на каком-либо уровне, вывод будет записан в неё; (b) если существуют повторяющиеся имена папок, вывод будет записан в папку, которая была изменена последней; (c) если имя папки не существует, будет создана новая папка в корневом каталоге; и (d) имена папок с разделителями (например, 'путь/к/файл') интерпретируются как строковые литералы, а не системные пути. По умолчанию используется корневой каталог Диска.
fileNamePrefix	Строка, необязательный параметр	Префикс имени файла. Может содержать буквы, цифры, дефисы, подчеркивания (_), пробелы (_). По умолчанию используется описание.
dimensions	Число|Строка, необязательно	Размеры, используемые для экспортируемого изображения. Принимает либо одно положительное целое число в качестве максимального размера, либо "ШИРИНА x ВЫСОТА", где ШИРИНА и ВЫСОТА — положительные целые числа.
region	Geometry.LinearRing|Geometry.Polygon|String, optional	Объект LinearRing, Polygon или координаты, представляющие область для экспорта. Их можно указать в виде объектов Geometry или в виде координат, сериализованных в виде строки.
scale	Число (необязательно)	Разрешение в метрах на пиксель. По умолчанию — 1000.
crs	Строка, необязательный параметр	Система координат (CRS), используемая для экспортируемого изображения.
crsTransform	List[Number]|String, optional	Аффинное преобразование для экспортируемого изображения. Требуется определить параметр "crs".
maxPixels	Число (необязательно)	Ограничьте количество пикселей при экспорте. По умолчанию, если экспорт превышает 1e8 пикселей, вы увидите ошибку. Явная установка этого значения позволяет увеличить или уменьшить этот лимит.
shardSize	Число (необязательно)	Размер в пикселях фрагментов, в которых будет вычислено это изображение. Значение по умолчанию — 256.
fileDimensions	List[Number]|Number, optional	Размеры каждого файла изображения в пикселях, если изображение слишком велико, чтобы поместиться в один файл. Можно указать одно число для обозначения квадратной формы или массив из двух измерений (ширина, высота). Обратите внимание, что изображение все равно будет обрезано по общим размерам изображения. Должно быть кратно 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.

Примеры

Редактор кода (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

Информацию об API Python и использовании 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:
# 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()