Method: projects.maps.create

创建一个 ID，用于渲染显示计算结果的地图图块。生成的 ID 应作为 GetTile 请求的一部分使用。

此属性与 GetTile 结合使用。调用 maps.create 会提供一个表达式和一些输出选项。maps.create 的结果是一个地图 ID，表示的是评估该表达式并应用这些选项后得到的图片。随后，可以调用 GetTile 来获取生成图片的任意位置和缩放级别下的某个图块的图片数据。地图 ID 的有效期为中等时间（几个小时）。

这对端点最常见的用例是使用某些计算输出的可视化结果填充地图视口。为此，计算输出必须满足对请求的图片格式的一些合理要求。具体而言，JPEG 或 PNG 格式要求有 1 个或 3 个输出波段，并且剪裁值超出 0-255 范围。

HTTP 请求

POST https://earthengine.googleapis.com/v1/{parent=projects/*}/maps

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。映射集合的父级（例如“projects/*”）。

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

  • earthengine.maps.create

查询参数

参数
workloadTag

string

用户提供的用于跟踪此计算的代码。

请求正文

请求正文包含一个 EarthEngineMap 实例。

响应正文

如果成功，响应正文将包含一个新创建的 EarthEngineMap 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

如需了解详情，请参阅 OAuth 2.0 Overview。