Method: projects.image.computePixels

對圖片資料執行任意運算，藉此計算像素區塊。

每項要求的未壓縮資料大小上限為 48 MB，計算方式為要求的像素尺寸、要求的圖像頻帶數量，以及每個頻帶的位元組數相乘。要求的大小也受到限制，每個維度的像素不得超過 32K，頻帶不得超過 1024 個。如果要求超出這些限制，就會傳回 400 (BAD_REQUEST) 錯誤代碼。

如果成功，回應主體會包含要求的像素資料，並以要求中 fileFormat 欄位指定的編碼方式呈現。

HTTP 要求

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:computePixels

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
project

string

應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 projects/{project-id}。

授權需要指定資源 project 的下列 IAM 權限：

  • earthengine.computations.create

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "expression": {
    object (Expression)
  },
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
欄位
expression

object (Expression)

要計算的運算式。
fileFormat

enum (ImageFileFormat)

用來傳回像素值的輸出檔案格式。
grid

object (PixelGrid)

描述如何重新投影及裁剪由 expression 計算的圖片的參數。如果沒有，系統會以原生投影方式傳回完整的計算圖像。
bandIds[]

string

如果存在，則會指定從評估 expression 的結果中選取特定一組頻帶。如果未指定，系統會選取 expression 產生的所有頻帶。
visualizationOptions

object (VisualizationOptions)

如果存在，則為一組視覺化選項，可用於產生資料的 8 位元 RGB 視覺化。
workloadTag

string

使用者提供的用於追蹤這項運算的代碼。

回應主體

如果成功，回應會是一般 HTTP 回應，其格式由方法定義。

授權範圍

需要下列其中一種 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。