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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
欄位
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 時指定。
停止生成地圖圖塊的縮放等級或比例。必須指定其中一項。以下列出互斥的欄位。回應中最多只會設定一個欄位：
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)，可讓您以遞增方式算繪縮放等級，直到但不包括最大子集 (如有提供)，順序不指定但具決定性。