Method: projects.image.computePixels

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

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

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

HTTP 要求

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