Earth Engine вводит квоты для некоммерческих проектов , чтобы защитить совместно используемые вычислительные ресурсы и обеспечить надежную работу для всех. Все некоммерческие проекты должны выбрать уровень квот до 27 апреля 2026 года , иначе по умолчанию будет использоваться уровень «Сообщество». Квоты вступят в силу для всех проектов (независимо от даты выбора уровня) 27 апреля 2026 года . Подробнее.

Эта страница переведена с помощью Cloud Translation API.

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, 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.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.toCloudStorage({
  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» .

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:
# display(image.projection())
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.toCloudStorage(
    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()

Export.image.toCloudStorage Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Примеры

Редактор кода (JavaScript)

Colab (Python)

Export.image.toCloudStorage