Method: projects.map.export

启动一个批处理流程，用于计算分块地图并将结果写入 Google Cloud Storage。

HTTP 请求

POST https://earthengine.googleapis.com/v1alpha/{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,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    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,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
字段
startZoom

integer

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

integer

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

boolean

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

boolean

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

string

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

object (GridDimensions)

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

object (GridDimensions)

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

integer

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

object (ZoomSubset)

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

integer

停止生成地图图块的缩放级别。
maxZoom
(deprecated)

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,
  "min": number,
  "max": number
}
字段
start

number

要生成图块的起始缩放级别子集 (ExportVideoMap)。此处，子集是一个双精度值，可让您以增量方式渲染缩放级别，例如 12.1 表示缩放级别 12 中前 10% 的图块（按某种未指定但确定的顺序）。
end

number

要为其生成图块的结束缩放级别子集 (ExportVideoMap)，允许您以递增方式渲染缩放级别，直至达到但不包括最大子集（如果已提供），顺序未指定但确定。
min
(deprecated)

number

要生成图块的起始缩放级别子集 (ExportVideoMap)。此处，子集是一个双精度值，可让您以增量方式渲染缩放级别，例如 12.1 表示缩放级别 12 中前 10% 的图块（按某种未指定但确定的顺序）。
max
(deprecated)

number

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