Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить некоммерческое право на сохранение доступа к Earth Engine.
Method: projects.image.export
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Инициирует пакетный процесс, который вычисляет изображение и записывает результат в одно из нескольких мест назначения.
HTTP-запрос
POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:export
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
project | string Идентификатор или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для этого запроса. Формат: projects/{project-id} . Для авторизации требуется следующее разрешение IAM для указанного project ресурса: -
earthengine.exports.create
|
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"expression": {
object (Expression )
},
"description": string,
"maxPixels": string,
"grid": {
object (PixelGrid )
},
"requestId": string,
"workloadTag": string,
"priority": integer,
// Union field export_options can be only one of the following:
"fileExportOptions": {
object (ImageFileExportOptions )
},
"assetExportOptions": {
object (ImageAssetExportOptions )
}
// End of list of possible types for union field export_options .
} |
Поля |
---|
expression | object ( Expression ) Выражение, которое возвращает изображение для вычисления и экспорта. |
description | string Удобочитаемое имя задачи. |
maxPixels | string ( Int64Value format) Максимальное количество пикселей для вычисления и экспорта. Это мера безопасности, которая не позволит вам случайно начать экспорт большего размера, чем вы планировали. Значение по умолчанию — 1e8 пикселей, но вы можете явно установить значение, чтобы увеличить или уменьшить этот предел. |
grid | object ( PixelGrid ) Параметры, описывающие, как изображение, вычисленное с помощью expression должно быть перепроецировано и обрезано. Если он отсутствует, полное вычисленное изображение возвращается в своей собственной проекции. |
requestId | string Уникальная строка, используемая для обнаружения повторяющихся запросов. Если один и тот же пользователь выполняет более одного запроса с одним и тем же непустым requestId , только один из этих запросов может успешно запустить длительную операцию. requestId может содержать символы a..z, A..Z, 0–9 или «-». requestId может иметь длину не более 60 символов. |
workloadTag | string Предоставленная пользователем метка для отслеживания этого вычисления. |
priority | integer Необязательный. Приоритет экспортной задачи в рамках проекта. Задачи с более высоким приоритетом планируются раньше. Должно быть целым числом от 0 до 9999. По умолчанию — 100, если не установлено. |
Поле объединения export_options . Опции, описывающие, где и как хранить результаты. export_options может быть только одним из следующих: |
fileExportOptions | object ( ImageFileExportOptions ) Если указано, настраивает экспорт в файл. |
assetExportOptions | object ( ImageAssetExportOptions ) Если указано, настраивает экспорт как актив Earth Engine. |
Тело ответа
В случае успеха тело ответа содержит экземпляр Operation
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/earthengine
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/devstorage.full_control
Для получения дополнительной информации см.OAuth 2.0 Overview .
Параметры изображенияассетэкспорт
Варианты сохранения изображений в качестве ресурсов Earth Engine.
JSON-представление |
---|
{
"pyramidingPolicy": enum (PyramidingPolicy ),
"pyramidingPolicyOverrides": {
string: enum (PyramidingPolicy ),
...
},
// Union field destination can be only one of the following:
"earthEngineDestination": {
object (EarthEngineDestination )
}
// End of list of possible types for union field destination .
} |
Поля |
---|
pyramidingPolicy | enum ( PyramidingPolicy ) Политика построения пирамид применяется по умолчанию ко всем группам. |
pyramidingPolicyOverrides | map (key: string, value: enum ( PyramidingPolicy )) Определенные переопределения политики пирамиды для каждого диапазона. Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
destination поля Союза. Куда писать результаты. destination может быть только одним из следующих: |
earthEngineDestination | object ( EarthEngineDestination ) Если указано, настраивает экспорт в Earth Engine. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[[["\u003cp\u003eInitiates an image processing batch job, computing and saving the result to various destinations like Earth Engine assets or as a file.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an expression to compute the image, a description for the task, and options for reprojection, clipping, and export destination.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over export parameters, including maximum pixels, request identifiers for duplication detection, workload tagging, and task priority.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ePOST\u003c/code\u003e method with the \u003ccode\u003ehttps://earthengine.googleapis.com/v1/{project=projects/*}/image:export\u003c/code\u003e endpoint for initiating the process.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],["This documentation describes initiating an image export batch process via a POST request to `https://earthengine.googleapis.com/v1/{project=projects/*}/image:export`. The request body defines the `expression` to compute, task `description`, `maxPixels`, and `grid` parameters. It also includes a `requestId` and `workloadTag` for tracking and deduplication. The `export_options` field determines if the result is a `file` or an Earth Engine `asset`, with the `asset` having options for `pyramidingPolicy`. Authorization requires specific IAM permissions and OAuth scopes.\n"],null,[]]