Method: projects.locations.videoThumbnails.create

创建一个 ID，用于渲染包含来自合集的多张图片的动画的图片。

此属性与 GetVideoThumbnailPixels 结合使用。调用 videoThumbnails.create 会提供一个表达式和一些输出选项。videoThumbnails.create 的结果是一个 ID，表示在对该表达式求值并应用这些选项后得到的图片。随后，可以调用 GetVideoThumbnailPixels 来获取一张图片，其中显示了 ImageCollection 的所有元素，并以动画形式从第一个元素到最后一个元素显示。该 ID 的有效期为中等时间（几小时）。

请求的总大小限制为 ImageCollection 中的所有图片的 512*512*100 像素。超出这些限制的请求将导致错误代码为 400 (BAD_REQUEST)。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。将在其中创建视频缩略图的位置的父级（例如“projects/*”）。

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

  • earthengine.videothumbnails.create

查询参数

参数
workloadTag

string

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

请求正文

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

响应正文

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

授权范围

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