Earth Engine 存取權

Earth Engine 在 Google Cloud 上執行，需要 Cloud 專案才能存取及管理 API。所有 Earth Engine 呼叫 (無論是來自程式碼編輯器、用戶端程式庫、應用程式或 REST API) 都會透過 Cloud 專案傳送，方便您在 Cloud 控制台中進行存取控管、資源管理及用量監控。

取得 Earth Engine 存取權

如要使用 Earth Engine，您必須有權存取符合下列條件的 Cloud 專案：

建立專案

前往 註冊頁面，建立並註冊新的 Cloud 專案，或註冊現有專案。

您可以在 Google Cloud 控制台中管理註冊程序期間建立的專案。您可以在 Cloud 控制台的 Earth Engine API 頁面中，啟用或停用 Earth Engine API。

手動步驟 (註冊頁面會自動執行)

建立 Cloud 專案

如果尚未建立 Google Cloud 專案，請先建立一個。您可以前往 Cloud Console 的專案頁面，或按一下下列按鈕：

建立 Cloud 專案

啟用 Earth Engine API

如要為專案啟用 Earth Engine API，請點選下列按鈕前往 Earth Engine API 頁面：

啟用 Earth Engine API

在 Earth Engine API 頁面中，請確認已選取專案，然後按一下「啟用」按鈕。

註冊專案以供商業或非商業用途

編輯專案的下列網址，前往該頁面，然後完成註冊流程。 

https://code.earthengine.google.com/register?project=my-project

建立素材資源資料夾 (選用)

您可以建立與您有權存取的 Cloud 專案相關聯的 Earth Engine 資產資料夾，方法是使用 earthengine create folder 指令，並採用這裡所述的路徑。 例如： 

earthengine create folder projects/my-project/assets/

您也可以在程式碼編輯器中為專案建立素材資源資料夾，方法是在「Assets」面板中新增專案。

除非您打算在專案中儲存資產，否則不需要建立這個資料夾。

使用現有專案

向貴機構的 IT 人員確認是否已設定 Earth Engine 適用的雲端專案。確認您用來存取 Earth Engine 服務的 Google 帳戶已獲得專案的正確角色和權限。

指定專案

以下各節說明如何為各種 Earth Engine 服務介面指定專案。

用戶端程式庫 (Python、JavaScript)

ee.Initialize() 函式用於指定專案，以處理源自 Python 和 JavaScript 用戶端程式庫的 Earth Engine 要求。您可以透過多種方式設定專案規格，詳情請參閱驗證和初始化頁面。

程式碼編輯器

按一下程式碼編輯器右上角的個人資料圖示，然後從選單中選取「變更 Cloud 專案」。從選取對話方塊中選擇專案。

Earth Engine 應用程式

發布 Earth Engine 應用程式時，系統會提示您選取要用來轉送要求的專案。按照發布對話方塊中的指示操作。

指令列工具

如要將指令列工具的 Earth Engine 呼叫與 Cloud 專案建立關聯，請在呼叫 earthengine 時使用 --project 參數，或使用 set_project 設定預設專案。

REST API

如要將 REST API 的呼叫與 Cloud 專案建立關聯，請發出經過驗證的 HTTP 呼叫，並由 oauth2 處理驗證。在本機環境中，您可以使用 gcloud 指令。您也可以使用與 Cloud 專案相關聯的服務帳戶。如需使用 google.oath.service_account.Credentials.from_service_account_file() 透過服務帳戶進行驗證的範例，請參閱 REST API 快速入門。

設定專案存取權

以下各節說明如何設定啟用 Earth Engine 的專案，供其他使用者和服務帳戶使用。

服務帳戶

只要註冊父項專案並啟用 Earth Engine API，服務帳戶就會自動取得存取權。他們也需要專案中的正確權限。專案中可設定任意數量的服務帳戶使用 Earth Engine。如要進一步瞭解如何搭配使用服務帳戶與 Earth Engine，請前往服務帳戶頁面。

Google 帳戶

Cloud 專案會使用 Cloud IAM 管理角色和權限。如要讓其他使用者透過您的專案存取 Earth Engine，請使用 Cloud 控制台授予他們正確的角色和權限。

OAuth 2.0 用戶端編號

您可能需要從專案建立 OAuth 2.0 用戶端 ID，例如建立可將使用者憑證傳遞至 Earth Engine 的應用程式。如要管理 Cloud 專案的憑證，請前往 Cloud 控制台選單 ()，然後依序選取「API 和服務」>「憑證」。(如果出現提示，請選擇專案)。

如要為專案建立新的用戶端 ID，請依序點選「+ 建立憑證」 >「OAuth 用戶端 ID」 >「網頁應用程式」。

在網頁應用程式的設定中：

  • 指定授權的 JavaScript 來源，例如：
http://localhost:8080
https://foo-ee-project.appspot.com
  • 指定已授權的重新導向 URI，例如：
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

進一步瞭解如何使用 OAuth 驗證使用者。

常見情況

我正在教導教育課程...

太好了！如果註冊非商業專案，則不需要設定帳單資訊。接著，您就可以將學生新增至專案。

我是營運團隊/商業機構的一員...

太好了！您可以註冊商業用途專案，並新增協作者。此外，請注意所選 Earth Engine 訂閱方案的座位限制。

刪除 Earth Engine 資料

帳戶層級刪除

帳戶層級的刪除作業會從帳戶中移除所有 Earth Engine 資料。

如果您的帳戶屬於 Google Workspace 機構，管理員會控管帳戶資料。管理員刪除 Google 帳戶後，系統會在 30 天內刪除所有相關聯的 Earth Engine 資料。

資料刪除後，Earth Engine 團隊就無法復原。

Cloud 專案

刪除 Cloud 專案時，系統會一併刪除與該專案相關聯的 Earth Engine 資料 (包括儲存在專案根目錄中的所有資產、專案層級的 EE 應用程式、監控資料等)。這項程序可能可在 30 天內復原，但超過 30 天後就無法復原。

素材資源

如要刪除資產，最簡單的方法是使用程式碼編輯器中的「資產」分頁，查看並手動刪除 Earth Engine 資產。

如要以程式輔助方式刪除 ID 為 projects/{project-id}/assets/{asset-id} 的資產 (例如 projects/my-project/assets/my-asset)：

Python 用戶端

ee.data.deleteAsset('projects/my-project/assets/my-asset')

JavaScript 用戶端

請注意，程式碼編輯器的安全沙箱會阻止這項呼叫在該環境中運作。

ee.data.deleteAsset('projects/my-project/assets/my-asset')

指令列工具

使用 rm 指令：

earthengine rm projects/my-project/assets/my-asset

程式碼編輯器指令碼

如要刪除 Earth Engine 程式碼編輯器指令碼，請按照下列步驟操作：

程式碼編輯器

在程式碼編輯器的「指令碼」分頁中，選取要刪除的指令碼或存放區。存放區標示為已刪除後，會在 30 天內無法復原。

使用 Git

進階使用者可以透過 Git 管理指令碼。如要列出可檢視的存放區，請參閱 https://earthengine.googlesource.com/。

Earth Engine 應用程式

如要刪除 Earth Engine 應用程式，請使用程式碼編輯器中的「應用程式」按鈕管理應用程式。

您可以使用「管理連結」頁面，查看及刪除程式碼編輯器中的「取得連結」連結。如要前往這個頁面，請在「取得連結」按鈕旁的下拉式選單中，選取「管理連結」。

設定非商業用途存取權

如要為專案設定非商業 (免付費) Earth Engine 存取權，請在 Cloud 控制台中填寫註冊問卷，確認專案是否符合資格。

驗證

由於 Earth Engine 會提供大量運算資源的免付費存取權，因此 Google 規定，凡是註冊非商業用途存取權的專案，都必須經過驗證。驗證程序是註冊程序的一部分。如果您填寫完驗證問卷，且專案判定為商業用途，您就必須付費才能使用 Earth Engine。

自 2025 年 9 月 26 日起，所有非商業專案都必須填寫 Cloud 控制台中的問卷。建議您盡快完成驗證程序。如未在 2025 年 9 月 26 日前採取行動，專案的 Earth Engine 存取權將暫停，直到您完成驗證程序為止。

重新驗證

所有具備非商業用途存取權的專案，都需要定期重新驗證存取權。

設定商業存取權

如要為專案設定商業 (付費) Earth Engine 存取權，請使用註冊頁面設定專案，並在帳單帳戶中選擇方案。

終止商業存取權

如果您是 Earth Engine 的直接客戶，並想停止在付費環境中使用 Earth Engine，請進行下列幾項變更，以免產生費用：

  • 停止收取訂閱費用

    • 如要終止帳單帳戶的 Earth Engine 訂閱方案，請使用「管理方案」頁面 (使用連結至該帳單帳戶的已註冊 Cloud 專案時，可從 Code Editor 右上角的使用者設定下拉式選單存取)。

    • 您也可以直接前往帳單帳戶的「管理方案」頁面：

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • 選擇「有限」方案後，帳單帳戶在目前帳單週期結束後，就不會再產生任何 Earth Engine 平台訂閱費用。

  • 停止收取運算費用

    • 如要避免產生新的運算相關費用 (EECU 時間)，請在 Cloud 專案中停用 Earth Engine API。請注意，這不會終止進行中的要求或刪除儲存的物件，因此即使停用 API，您可能仍會產生 Earth Engine 費用。
    • 如要瞭解如何停用 API，請參閱 API 控制台說明。

  • 停止支付儲存空間費用

    • 即使停用 API，儲存的 Earth Engine 資產仍會產生費用。刪除資產後，就不會再產生 EE 儲存空間費用。