Method: projects.locations.thumbnails.create

创建一个 ID，用于呈现“缩略图”图片。

此属性与 GetThumbnailPixels 结合使用。调用 thumbnails.create 会提供一个表达式和一些输出选项。thumbnails.create 的结果是一个 ID，表示在对该表达式求值并应用这些选项后得到的图片。随后，可以调用 GetThumbnailPixels 来获取整个生成图片的图片数据。该 ID 的有效期为中等时间（几小时）。

这对端点的最常见用例是通过 POST 向 thumbnails.create 提供复杂表达式，然后通过 GET 向 GetThumbnailPixels 提取计算的图片。与 ComputePixels 相比，这种两步流程可在更多情况下使用。具体而言：- 需要解封装 ComputePixels 的结果，才能获取编码的图片字节。浏览器可以直接显示 GetThumbnailPixels 的结果。- 只有已获授权的用户才能使用范围适当的 OAuth 令牌调用 ComputePixels。thumbnails.create 也存在相同的限制，但可以使用包含 API 密钥的网址调用 GetThumbnailPixels，因此调用它的网址可以更广泛地使用。

对表达式求值的结果必须满足对请求的图片格式的一些合理要求。具体而言，JPEG 或 PNG 格式要求有 1 个或 3 个输出波段，并且剪裁值超出 0-255 范围。

说明“缩略图”并不意味着对计算图片的大小有限制：thumbnails.create/GetThumbnailPixels 适用与 ComputePixels 相同的限制。每个请求的未压缩数据量上限为 48MB，计算方法为请求尺寸（以像素为单位）、请求的图像波段数以及每个波段的每个像素字节数的乘积。请求的任一尺寸不得超过 32K 像素，且不得超过 1024 个波段。超出这些限制的请求将导致错误代码为 400 (BAD_REQUEST)。

HTTP 请求

POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/thumbnails

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。缩略图集合的父级（例如“projects/*”）。

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

  • earthengine.thumbnails.create

查询参数

参数
workloadTag

string

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

请求正文

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

响应正文

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

授权范围

需要以下 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。