Method: projects.map.export

啟動批次程序，計算平鋪地圖並將結果寫入 Google Cloud Storage。

HTTP 要求

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

路徑參數

參數
project

string

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

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

  • earthengine.exports.create

要求主體

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

JSON 表示法 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
欄位
expression

object (Expression)

這個運算式會評估為要計算及匯出的圖片。系統會根據圖片邊界判斷要算繪哪些地圖圖塊。如要控制匯出的區域，請在匯出前裁剪圖片。
description

string

任務的使用者可讀名稱。
tileOptions

object (TileOptions)

描述要產生地圖圖塊的選項。
tileExportOptions

object (ImageFileExportOptions)

匯出地圖圖塊的位置和格式選項。目前只有 Cloud Storage 支援地圖匯出功能。
requestId

string

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

string

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

integer

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

回應主體

如果成功，回應主體會包含 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。

TileOptions

說明要匯出的圖片或影片地圖圖塊的選項。

JSON 表示法 
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
欄位
startZoom

integer

開始產生地圖圖塊以供匯出的縮放等級。預設值為零。
skipEmpty

boolean

如果為 true，則略過寫入空白 (即完全透明) 地圖圖塊。
mapsApiKey

string

產生地圖圖塊檢視器時使用的選用 Google 地圖平台 API 金鑰。
dimensions

object (GridDimensions)

輸出影片圖塊的寬度和高度，僅用於匯出圖塊式影片金字塔 (ExportVideoMap)。
stride

integer

圖塊列和欄間距。(ExportVideoMap) 如要取得最高相容性，請將此值設為 4 (僅限 WebGL) 或 1 (預設值)。
zoomSubset

object (ZoomSubset)

要產生圖塊的縮放等級子集。只能在對 ExportVideoMap 的呼叫中指定。
聯集欄位 end_zoom_or_scale。停止產生地圖圖塊的縮放等級或比例。必須指定其中一個。end_zoom_or_scale 只能是下列其中一項：
endZoom

integer

停止產生地圖圖塊的縮放等級。
scale

number

圖片解析度上限，以每像素公尺為單位。系統會將比例尺轉換為赤道上最適合的最大縮放等級。

ZoomSubset

要產生圖塊 (ExportVideoMap) 的縮放等級子集，開始和結束子集為雙精度值，可讓您逐漸算繪縮放等級或等級。如要轉譯整個金字塔，並設定 12 的起始縮放比例：startZoom=0，endZoom=12，請勿設定這則訊息。如要算繪 0 到 11 級別，以及第 12 級別的前 10%，請使用以下參數：startZoom=0, endZoom=12, subset = {min=0, max=12.1 }。如要算繪第 12 級別的下一個 10%，請使用以下參數：startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 }。如要算繪第 12 級別的剩餘 80%，請使用以下參數：startZoom=0, endZoom=12, subset = {min=12.2, max=13 }。此外，請注意，所有匯出區塊的 start/endZoom 都必須是相同的 (完整) 金字塔大小。

JSON 表示法 
{
  "start": number,
  "end": number
}
欄位
start

number

要產生圖塊的起始縮放等級子集 (ExportVideoMap) 在此處，子集是雙精度值，可讓您逐步算繪縮放等級，因此 12.1 是縮放 12 中圖塊的前 10%，以某種未指定但確定的順序。
end

number

產生圖塊 (ExportVideoMap) 的結束縮放等級子集，可讓您以逐步方式算繪縮放等級，最多可達到 (但不包含) 某個未指定但確定的順序中的最大子集 (如有提供)。