Method: projects.map.export

启动批量处理，以计算平铺地图并将结果写入 Google Cloud Storage。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
project

string

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

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

  • earthengine.exports.create

请求正文

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

JSON 表示法 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
字段
expression

object (Expression)

一个表达式，用于计算并导出图片。图片的边界将用于确定要呈现的地图图块集。如需控制导出的区域，请在导出之前剪裁图片。
description

string

任务的人类可读名称。
tileOptions

object (TileOptions)

描述要生成的地图图块的选项。
tileExportOptions

object (ImageFileExportOptions)

用于指定导出地图图块的位置和格式的选项。目前，Cloud Storage 是唯一受支持的地图导出目标位置。
requestId

string

用于检测重复请求的唯一字符串。如果同一用户使用相同的非空 requestId 发出多个请求，则只有其中一个请求可以成功启动长时间运行的操作。requestId 可以包含字符 a..z、A..Z、0-9 或“-”。requestId 的长度最多为 60 个字符。
workloadTag

string

用户提供的标签，用于跟踪此计算。
priority

integer

可选。导出任务在项目中的优先级。优先级较高的任务会更早安排。必须是介于 0 和 9999 之间的整数。如果未设置，则默认为 100。

响应正文

如果成功，则响应正文包含一个 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。

TileOptions

描述要导出的图片或视频地图图块的选项。

JSON 表示法 
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
字段
startZoom

integer

开始生成要导出的地图图块的缩放级别。默认为零。
skipEmpty

boolean

如果为 true，则跳过写入空（即完全透明）地图图块。
mapsApiKey

string

生成的地图图块查看器的可选 Google Maps Platform API 密钥。
dimensions

object (GridDimensions)

输出视频图块的宽度和高度，仅用于导出平铺视频金字塔 (ExportVideoMap)。
stride

integer

图块行和列步长。(ExportVideoMap) 对于稀疏图块（仅限 WebGL），请设置为 4；对于最大兼容性，请设置为 1（默认值）。
zoomSubset

object (ZoomSubset)

要为其生成图块的缩放级别子集。只能在对 ExportVideoMap 的调用中指定。
停止生成地图图块的缩放级别或比例。必须指定其中一个。以下是互斥字段的列表。在响应中，最多只能设置一个字段：
endZoom

integer

停止生成地图图块的缩放级别。
scale

number

每像素的最大图片分辨率（以米为单位）。比例将转换为赤道处最合适的最高缩放级别。
互斥字段结束。

ZoomSubset

要为其生成图块的缩放级别子集 (ExportVideoMap)。开始和结束子集是双精度值，可让您以增量方式呈现一个或多个缩放级别。如需呈现起始缩放级别为 12 的整个金字塔：startZoom=0，endZoom=12，请勿设置此消息。如需呈现级别 0-11 和级别 12 的前 10%：startZoom=0，endZoom=12，subset = {min=0, max=12.1 } 如需呈现级别 12 的接下来的 10%：startZoom=0，endZoom=12，subset = {min=12.1, max=12.2 } 如需呈现级别 12 的剩余 80%：startZoom=0，endZoom=12，subset = {min=12.2, max=13 } 另请注意，所有导出分片在 start/endZoom 中都必须具有相同（完整）的金字塔大小。

JSON 表示法 
{
  "start": number,
  "end": number
}
字段
start

number

开始缩放级别子集，用于生成图块 (ExportVideoMap)。在此处，子集是双精度值，可让您以增量方式呈现缩放级别，因此，例如 12.1 是缩放级别 12 中前 10% 的图块，顺序未指定但确定。
end

number

结束缩放级别子集，用于生成图块 (ExportVideoMap)，可让您以增量方式呈现缩放级别，直至但不包括最大子集（如果提供），顺序未指定但确定。