Method: projects.image.export

启动一个批处理，用于计算图片并将结果写入多个目的地之一。

HTTP 请求

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

  // 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。

ImageAssetExportOptions

将图片另存为 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。