Method: projects.videoThumbnails.create

建立可用於算繪圖片的 ID，其中包含來自集合的多張圖片動畫。

此選項會與 videoThumbnails.getPixels 搭配使用。呼叫 videoThumbnails.create 會提供運算式和一些輸出選項。videoThumbnails.create 的結果是代表圖片的 ID，該 ID 是評估該運算式並套用這些選項的結果。接著，您可以呼叫 videoThumbnails.getPixels 來取得圖片，顯示 ImageCollection 的所有元素，並以動畫呈現從第一個到最後一個元素。ID 的有效時間為數小時。

在 ImageCollection 中，所有圖片的總像素數量上限為 512 x 512 x 100。如果要求超出這些限制，就會傳回 400 (BAD_REQUEST) 錯誤代碼。

HTTP 要求

POST https://earthengine.googleapis.com/v1/{parent=projects/*}/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。