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

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
字段
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) 设置为 4 表示稀疏图块（仅限 WebGL），设置为 1（默认）表示最大兼容性。
zoomSubset

object (ZoomSubset)

要为其生成图块的缩放级别的子集。只能在对 ExportVideoMap 的调用中指定。
联合字段 end_zoom_or_scale。停止为其生成地图图块的缩放级别或比例。必须指定其中一个。end_zoom_or_scale 只能是下列其中一项：
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)，可让您以某种未指定但确定性的顺序增量渲染缩放级别，但不包括最大子集（如果已提供）。