| Использование | Возвраты |
|---|---|
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 } });
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()