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)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
字段
startZoom

integer

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

boolean

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

string

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

object (GridDimensions)

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

integer

功能块行和列步长。(ExportVideoMap) 设置为 4 表示稀疏图块（仅限 WebGL），设置为 1（默认）表示最大兼容性。
zoomSubset

object (ZoomSubset)

要为其生成图块的缩放级别的子集。只能在对 ExportVideoMap 的调用中指定。
联合字段 end_zoom_or_scale。停止为其生成地图图块的缩放级别或比例。必须指定其中一个。end_zoom_or_scale 只能是下列其中一项：
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 } 另请注意，所有导出分片的 startZoom/endZoom 必须具有相同的（完整）金字塔大小。

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

number

要为其生成图块的起始缩放级别子集 (ExportVideoMap)。在这里，子集是一个双精度值，可让您增量渲染缩放级别，因此，例如 12.1 是缩放级别 12 中前 10% 的图块，按某种未指定但确定性的顺序排列。
end

number

要为其生成图块的结束缩放级别子集 (ExportVideoMap)，可让您以某种未指定但确定性的顺序增量渲染缩放级别，但不包括最大子集（如果已提供）。