Method: projects.image.export

启动一个批处理流程，该流程会计算映像并将结果写入多个目标位置之一。

HTTP 请求

POST https://earthengine.googleapis.com/v1alpha/{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)

要计算和导出的像素数量上限。这是一项安全措施，可防止您意外启动比预期更大的导出任务。默认值为 1 亿像素，但您可以明确设置该值来提高或降低此上限。
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 的导出。
互斥字段的结束位置。