Export.image.toCloudStorage

Создает пакетную задачу для экспорта изображения в виде растра в Google Cloud Storage. Задачи можно запустить на вкладке «Задачи».

«crsTransform», «scale» и «dimensions» являются взаимоисключающими.

Использование	Возвраты
Export.image.toCloudStorage(image, description , bucket , fileNamePrefix , dimensions , region , scale , crs , crsTransform , maxPixels , shardSize , fileDimensions , skipEmptyTiles , fileFormat , formatOptions , priority )

Аргумент	Тип	Подробности
image	Изображение	Изображение для экспорта.
description	Строка, необязательно	Удобочитаемое имя задачи. По умолчанию "myExportImageTask".
bucket	Строка, необязательно	Целевой контейнер облачного хранилища.
fileNamePrefix	Строка, необязательно	Строка, используемая в качестве префикса вывода. Завершающий "/" указывает путь. По умолчанию — описание задачи.
dimensions	Число|Строка, необязательно	Размеры, которые следует использовать для экспортируемого изображения. Принимает либо одно положительное целое число в качестве максимального размера, либо «ШИРИНАxВЫСОТА», где ШИРИНА и ВЫСОТА — положительные целые числа.
region	Geometry.LinearRing|Geometry.Polygon|String, необязательно	LinearRing, Polygon или координаты, представляющие регион для экспорта. Они могут быть указаны как объекты Geometry или координаты, сериализованные как строка.
scale	Номер, необязательно	Разрешение в метрах на пиксель. По умолчанию 1000.
crs	Строка, необязательно	CRS для использования в экспортируемом изображении.
crsTransform	Список<Число>|Строка, необязательно	Аффинное преобразование для использования в экспортированном изображении. Требует определения "crs".
maxPixels	Номер, необязательно	Ограничьте количество пикселей в экспорте. По умолчанию вы увидите ошибку, если экспорт превысит 1e8 пикселей. Явная установка этого значения позволяет повысить или понизить этот предел.
shardSize	Номер, необязательно	Размер в пикселях плиток, в которых будет вычисляться это изображение. По умолчанию 256.
fileDimensions	Список<Номер>|Номер, необязательно	Размеры в пикселях каждого файла изображения, если изображение слишком велико для размещения в одном файле. Можно указать одно число для обозначения квадратной формы или массив из двух измерений для обозначения (ширина, высота). Обратите внимание, что изображение все равно будет обрезано до общих размеров изображения. Должно быть кратно shardSize.
skipEmptyTiles	Булево, необязательно	Если true, пропускает запись пустых (т.е. полностью замаскированных) фрагментов изображения. По умолчанию false. Поддерживается только при экспорте GeoTIFF.
fileFormat	Строка, необязательно	Формат файла строки, в который экспортируется изображение. В настоящее время поддерживаются только «GeoTIFF» и «TFRecord», по умолчанию «GeoTIFF».
formatOptions	ImageExportFormatConfig, необязательно	Словарь строковых ключей для опций, специфичных для формата. Для «GeoTIFF»: «cloudOptimized» (Boolean), «noData» (float). Для «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.toCloudStorage({
  image: image,
  description: 'image_export',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export',
  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.toCloudStorage({
  image: image,
  description: 'image_export_crstransform',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_crstransform',
  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.toCloudStorage({
  image: image,
  description: 'image_export_maxpixels',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_maxpixels',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  maxPixels: 1e13
});

// Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
// parameter to true.
Export.image.toCloudStorage({
  image: image,
  description: 'image_export_cog',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_cog',
  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',
  bucket: 'gcs-bucket-name',
  fileNamePrefix: 'image_export_nodata',
  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 Environment .

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.toCloudStorage(
    image=image,
    description='image_export',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export',
    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.toCloudStorage(
    image=image,
    description='image_export_crstransform',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_crstransform',
    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.toCloudStorage(
    image=image,
    description='image_export_maxpixels',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_maxpixels',
    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.toCloudStorage(
    image=image,
    description='image_export_cog',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_cog',
    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',
    bucket='gcs-bucket-name',
    fileNamePrefix='image_export_nodata',
    region=image.geometry(),  # full image bounds
    scale=2000,  # large scale for minimal demo
    crs='EPSG:5070',
    fileFormat='GeoTIFF',
    formatOptions={
       'noData': nodata_val
    }
)
task.start()