Method: projects.image.export

啟動批次程序,計算圖片並將結果寫入其中一個目的地。

HTTP 要求

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:export

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

路徑參數

參數
project

string

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

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

  • earthengine.exports.create

要求主體

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

JSON 表示法
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
欄位
expression

object (Expression)

評估為要運算及匯出的圖片的運算式。

description

string

任務的使用者可讀名稱。

maxPixels

string (Int64Value format)

要運算及匯出的像素數量上限。這項安全防護措施可避免你不小心啟動比預期更大的匯出作業。預設值為 1e8 像素,但您可以明確設定值,提高或降低此限制。

grid

object (PixelGrid)

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

requestId

string

用於偵測重複要求的不重複字串。如果同一位使用者使用相同的非空白 requestId 提出多個要求,只有其中一個要求才能成功啟動長時間執行作業。requestId 可包含 a..z、A..Z、0-9 或「-」字元。requestId 的長度上限為 60 個半形字元。

workloadTag

string

使用者提供的標籤,用於追蹤這項運算。

priority

integer

選用設定。專案中匯出工作的重要性。優先順序較高的任務會排定較早的時間。須為介於 0 至 9999 之間的整數。如果未設定,預設值為 100。

聯集欄位 export_options。說明結果儲存位置和儲存方式的選項。export_options 只能是下列其中一項:
fileExportOptions

object (ImageFileExportOptions)

如果指定此值,系統會將匯出作業設為���案。

assetExportOptions

object (ImageAssetExportOptions)

如果指定此值,系統會將匯出內容設為 Earth Engine 資產。

回應主體

如果成功,回應主體會包含 Operation 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

詳情請參閱 OAuth 2.0 Overview

ImageAssetExportOptions

將圖片儲存為 Earth Engine 資產的選項。

JSON 表示法
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
欄位
pyramidingPolicy

enum (PyramidingPolicy)

預設套用至所有頻帶的金字塔政策。

pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

特定頻段金字塔政策覆寫值。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

聯集欄位 destination。結果寫入位置。destination 只能是下列其中一項:
earthEngineDestination

object (EarthEngineDestination)

如果指定此值,系統就會設定匯出至 Earth Engine。