Method: projects.locations.thumbnails.create

建立可用於算繪「縮圖」圖片的 ID。

此選項會與 GetThumbnailPixels 搭配使用。呼叫 thumbnails.create 會提供運算式和一些輸出選項。thumbnails.create 的結果是代表圖片的 ID，該 ID 是評估該運算式並套用這些選項的結果。接著，您可以呼叫 GetThumbnailPixels，取得整個產生圖片的圖片資料。ID 的有效時間為數小時。

這組端點最常見的用途是透過 POST 至 thumbnails.create 提供複雜的運算式，然後透過 GET 至 GetThumbnailPixels 擷取已計算的圖片。這個兩階段程序比 ComputePixels 更適合用於更多情況。具體來說：- ComputePixels 的結果需要展開，才能取得已編碼的圖片位元組。瀏覽器可以直接顯示 GetThumbnailPixels 的結果。- ComputePixels 只能由已授權的使用者使用適當範圍的 OAuth 權杖呼叫。thumbnails.create 有相同的限制，但 GetThumbnailPixels 可透過含有 API 金鑰的網址叫用，因此叫用它的網址可更廣泛地使用。

評估運算式的結果必須符合要求的圖片格式的一些合理規定。具體來說，JPEG 或 PNG 格式需要一或三個輸出頻帶，以及超出 0 到 255 範圍的剪輯值。

「縮圖」說明並未限制所產生圖片的大小：ComputePixels 的限制也適用於 thumbnails.create/GetThumbnailPixels。每個要求的未壓縮資料大小上限為 48 MB，計算方式為要求的像素尺寸、要求的圖像頻帶數量，以及每個頻帶的每個像素位元組數量乘積。要求的大小也受到限制，每個維度的像素不得超過 32K，頻帶不得超過 1024 個。如果要求超出這些限制，就會傳回 400 (BAD_REQUEST) 錯誤代碼。

HTTP 要求

POST https://earthengine.googleapis.com/v1beta/{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。