Method: projects.image.export

启动批量处理，计算图片并将结果写入多个目标位置之一。

HTTP 请求

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:export

网址采用 gRPC 转码语法。

路径参数

参数
project

string

Google Cloud Platform 项目的项目 ID 或项目编号，应将其视为此请求的服务使用方。格式为 projects/{project-id}。

必须对指定的资源 project 具有以下 IAM 权限才能进行授权：

  • earthengine.exports.create

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
字段
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。
描述结果的存储位置和方式的选项。以下是互斥字段的列表。在响应中，最多只能设置其中一个字段：
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。

ImageAssetExportOptions

用于将图片另存为 Earth Engine 资产的选项。

JSON 表示法 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
字段
pyramidingPolicy

enum (PyramidingPolicy)

默认应用于所有波段的叠放政策。
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

特定于每个波段的叠放政策替换。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
写入结果的位置。以下是互斥字段的列表。在响应中，最多只能设置其中一个字段：
earthEngineDestination

object (EarthEngineDestination)

如果指定，则将导出配置为 Earth Engine。
互斥字段结束。