Method: projects.locations.maps.create

建立可用於算繪顯示運算結果的地圖圖塊的 ID。產生的 ID 應用於 GetTile 要求。

此選項會與 GetTile 搭配使用。呼叫 maps.create 會提供運算式和一些輸出選項。maps.create 的結果是地圖 ID，代表圖片，是評估該運算式並套用這些選項的結果。接著，您可以呼叫 GetTile，在任何所需位置和縮放等級取得產生圖片的圖塊圖片資料。地圖 ID 的效期為一段時間 (幾小時)。

這組端點最常見的用途，是透過某些運算的輸出結果視覺化，填入地圖可視區域。為達到這個目的，計算輸出內容必須符合要求圖片格式的合理條件。具體來說，JPEG 或 PNG 格式需要一或三個輸出頻帶，以及超出 0 到 255 範圍的剪輯值。

HTTP 要求

POST https://earthengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/maps

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

路徑參數

參數
parent

string

必要欄位。地圖集合的父項 (例如「projects/*」)。

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

  • earthengine.maps.create

查詢參數

參數
workloadTag

string

使用者提供的用於追蹤這項運算的代碼。

要求主體

要求主體包含 EarthEngineMap 的例項。

回應主體

如果成功，回應主體會包含新建立的 EarthEngineMap 例項。

授權範圍

需要下列其中一種 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。