Method: projects.map.export

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

HTTP 要求

POST https://earthengine.googleapis.com/v1alpha/{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,
  "minZoom": integer,
  "skipEmpty": boolean,
  "skipEmptyTiles": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "tileDimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

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

integer

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

integer

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

boolean

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

boolean

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

string

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

object (GridDimensions)

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

object (GridDimensions)

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

integer

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

object (ZoomSubset)

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

integer

停止產生地圖圖塊的縮放等級。
maxZoom
(deprecated)

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,
  "min": number,
  "max": number
}
欄位
start

number

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

number

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

number

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

number

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