Cloud Assets

Earth Engine 資產 (例如圖片、表格) 可能是舊版資產 (即未與雲端專案相關聯),或與 Google 雲端專案相關聯的資產。本指南說明如何使用資產管理工具上傳及/或使用與雲端專案相關聯的資產。

Cloud Asset 管理員

Cloud Asset Manager 包含「Cloud Assets」部分、「Legacy Assets」部分和「Add A Project」按鈕。

Cloud Asset 管理員
圖 1. Earth Engine 程式碼編輯器的 Cloud Asset Manager。

Cloud 資產

「Cloud Assets」部分包含屬於任何固定至資產管理工具的雲端專案的資產。根據預設,系統會顯示為程式碼編輯器工作階段選取的雲端專案 (如程式碼編輯器右上方所示)。如要固定其他專案,請選擇「新增專案」按鈕,然後在「選取雲端專案」對話方塊中選取專案。這些專案中的資產會顯示在初始展開的 Zippy 中,巢狀資料夾則會初始收合。

舊版素材資源

舊版資產是指在 Earth Engine 整合 Cloud 之前,與 Earth Engine 帳戶相關聯的資產。

新增專案

按一下「Add a Project」(新增專案) 按鈕,開啟「Select a Cloud Project」(選取雲端專案) 對話方塊。

「選取專案」對話方塊
圖 2. 「選取雲端專案」對話方塊。

這個對話方塊會顯示下拉式選單,供您選取雲端專案,並顯示該專案中的 Earth Engine 資產。您先前固定的專案會顯示為「Earth Engine Enabled Projects」。在下拉式選單中選取雲端專案,然後按一下「Select」(選取),即可將專案固定到「Cloud Assets」(Cloud 資產) 專區,並顯示專案中的資產。

如果選取已固定的專案,系統會改為提供取消固定專案的選項。

上傳資產

使用「上傳素材資源」按鈕上傳素材資源。根據預設,上傳的素材資源會與在程式碼編輯器中選取的專案建立關聯。如要將新資產與其他專案建立關聯,請透過上傳對話方塊提供的專案挑選器選取其他專案。

管理素材資源

資產可透過程式碼編輯器的「Asset Manager」分頁、指令列、用戶端程式庫 (例如 ee.data.getAsset) 或直接透過 REST API 進行管理。

管理資產權限

如要授予其他使用者資產的讀取、寫入或完整管理控制權限,您可以設定資產和/或專案的權限。詳情請參閱「存取控管」頁面。

存取資產

素材資源路徑的格式為 projects/${PROJECT_NAME}/assets/${ASSET_NAME}。 這些路徑用於用戶端程式庫建構函式、透過其中一個用戶端程式庫匯出、擷取或上傳時,以及 REST API 呼叫。

公開素材資源

您可以透過 projects/earthengine-public/assets/path/to/asset/asset-id 等路徑存取公開目錄中的圖片。例如,以下是 Landsat 場景:

projects/earthengine-public/assets/LANDSAT/LC08/C02/T1_RT/LC08_001004_20140609

請注意,本例中的 PROJECT_NAME 為 earthengine-public。 這些路徑可以直接傳遞至建構函式,例如 Image、ImageCollection 或 FeatureCollection。您也會將資產路徑傳遞至 REST API。這裡是 REST 快速入門導覽課程中的一個簡單範例。

個人資產

如要存取儲存在您擁有或有權查看的專案中的 Earth Engine 資產,請將 PROJECT_NAME 設為擁有該資產的專案 ID。例如:

projects/my-ee-enabled-project-id/assets/my-asset-id

在本範例中,my-ee-enabled-project-id 是先前上傳或建立資產的專案名稱。如要進一步瞭解如何在雲端專案中啟用 Earth Engine API,請參閱「專案」頁面。

舊版素材資源

舊版素材資源是指儲存在舊版 users/ 或 projects/ 資料夾中的素材資源。存取這些資產時,PROJECT_NAME 為 earthengine-legacy。例如:

projects/earthengine-legacy/assets/users/user-name/my-asset-id

存取 Cloud Storage 中的圖片

您可以使用 ee.Image.loadGeoTIFF(),直接從 Cloud Storage bucket 存取雲端最佳化 GeoTIFF (COG)。您也可以按照 COG 註冊指南中的說明,建立 COG 支援的 Earth Engine 資產;如需總覽,請參閱「Earth Engine 中的 COG」。