Earth Engine 應用程式

簡介

Earth Engine 應用程式提供 Earth Engine 分析的共用動態使用者介面。有了應用程式,專家就能透過簡單的 UI 元素,運用 Earth Engine 的資料目錄和分析能力,讓專家和非專家都能使用。

您可以透過在發布時產生的應用程式專屬網址,存取從 Earth Engine 發布的應用程式。您無須擁有 Earth Engine 帳戶,即可查看或與已發布的應用程式互動。由創作者選為精選的應用程式,也會顯示在使用者專屬的應用程式相簿中 (例如USERNAME.users.earthengine.app)。

建構應用程式

Earth Engine 應用程式可利用程式碼編輯器中使用的大部分函式,但也有少數例外狀況。此外,我們在設計使用者介面 API 時,也考量到應用程式開發人員的需求。如果您是使用者介面 API 的新手,請參閱 UI API 總覽

發布應用程式

如要透過 Code Editor 發布應用程式,請先載入要轉換為應用程式的指令碼,然後開啟應用程式管理面板。您可以按一下 Code Editor 中指令碼部分上方的「Apps」按鈕,存取該面板。

「管理應用程式」按鈕
管理應用程式按鈕

然後按一下「NEW APP」按鈕。

新增應用程式按鈕
新應用程式按鈕

在對話方塊中,選擇編輯器存取權、應用程式名稱,選取 Google Cloud 專案,並指定應用程式原始碼的位置。您可以使用「限制」分頁中的選項,將此應用程式的存取權限制為特定 Google 群組,或讓一般使用者存取。對於可公開存取的應用程式,您也可以在「相片庫」分頁中為應用程式提供自訂預覽圖片和說明。如果您希望這個應用程式出現在 USERNAME.users.earthengine.app 的公開應用程式圖庫中,請按一下「在應用程式集錦中推薦這個應用程式」。您可以選擇在應用程式的左上角加入自訂標誌,方法是從「標誌」分頁上傳所選圖片。

選擇編輯存取權
選擇編輯存取權:選擇哪些使用者可以編輯應用程式。
發布應用程式、名稱和網址
發布應用程式:選擇名稱、應用程式 ID 和 Cloud 專案。
發布應用程式和原始碼
發布應用程式:選取應用程式原始碼
發布應用程式、發布詳細資料
發布應用程式:選擇選項,例如在相片庫中精選應用程式、存取權限限制和自訂標誌

管理您的應用程式

如要透過程式碼編輯器管理應用程式,請按一下程式碼編輯器中腳本部分上方的「應用程式」按鈕,開啟「應用程式管理」面板。您可以在這裡更新應用程式設定或刪除應用程式。

管理應用程式
管理應用程式

與其他人協作使用專案擁有的應用程式

根據預設,您以使用者名稱發布的應用程式,只有您可以編輯。您可以透過專案擁有的應用程式,在應用程式中進行協作。專案擁有的應用程式是指由 Cloud 專案擁有並發布的應用程式;凡是具有 Earth Engine 應用程式發布者 IAM 角色的使用者,都可以編輯及刪除 Cloud 專案下發布的應用程式。進一步瞭解 Earth Engine IAM 角色

如要啟用專案擁有權應用程式,請在「選擇編輯權限」步驟中選擇「Cloud 專案」選項,然後選取要使用的 Cloud 專案,再按照正常程序完成應用程式發布流程。應用程式會發布至 PROJECT-ID.projects.earthengine.app 網域,任何具備 Cloud 專案 Earth Engine 應用程式發布者 IAM 角色的使用者都能編輯。

發布專案擁有的應用程式
發布專案擁有的應用程式

如要查看 Cloud 專案的應用程式,請按一下「ADD CLOUD PROJECT」按鈕,然後選取 Cloud 專案。

新增 Cloud 專案
新增 Cloud 專案

如要與他人分享雲端專案,請按下「分享專案」按鈕。 系統會將您導向專案的 Cloud Console IAM 頁面,您可以在該頁面中授予協作者 Earth Engine Apps Publisher IAM 角色。

開啟專案擁有的應用程式
編輯及刪除專案擁有的應用程式

常見問題

如何從應用程式市集中移除應用程式?
應用程式設定頁面上的「精選此應用程式」核取方塊,可控制應用程式是否會顯示在「精選應用程式」頁面上。存取權受限的應用程式無法列為精選。
我的 Earth Engine 程式碼是否可供他人查看?
是的,任何可以存取應用程式的人。雖然在應用程式發布時,這項資訊並不會清楚顯示,但只要觀察網路瀏覽器的網路流量,就能輕鬆查看應用程式的 JavaScript。舉例來說,在 Chrome 中,您可以查看開發人員工具的 網路面板,即可看到 JavaScript。
已發布的應用程式出現「載入地圖的部分內容時發生錯誤」錯誤的可能原因有哪些?
請確認應用程式中使用的所有圖片或表格素材資源都是公開共用或與應用程式共用。在素材資源共用對話方塊中,選取「任何人都可以讀取」選項,或從下拉式清單中選擇應用程式名稱。如果應用程式僅限 Google 群組使用,與該 Google 群組分享素材資源後,應用程式不會顯示該素材資源;您應改為與應用程式或公開分享素材資源。
為什麼我會看到「應用程式尚未就緒」頁面?
建立應用程式後,系統可能需要一段時間才能傳播相關資訊。這通常會在幾分鐘內解決。如果錯誤持續發生,請尋求協助
為什麼我的應用程式會顯示繪製的幾何圖形?
這麼做可讓您輕鬆在應用程式中顯示參考幾何圖形,並讓使用者編輯幾何圖形。如果您不想讓特定幾何圖形顯示或編輯,可以在發布應用程式前隱藏或鎖定個別幾何圖形圖層,以免使用者看到或編輯這些圖層。請參閱 幾何圖形工具說明文件,瞭解詳情。
什麼是應用程式配額?
為避免錯誤或耗用大量資源的指令碼對服務的可用性造成負面影響,Earth Engine 針對並行查詢設有應用程式用量配額。這個配額的運作方式與 Earth Engine 的 每位使用者配額類似,但配額會與應用程式連結,而非特定使用者。
我建立的每個應用程式都有自己的配額嗎?
是的,每個應用程式都會與專屬配額相關聯。對於使用 API 金鑰建立的舊版應用程式,配額會與您用來產生應用程式 API 金鑰的 Cloud 專案相關聯。如果您從同一個 Cloud 專案產生多個 API 金鑰,這些金鑰都會共用相同的用量配額。
為何需要 Cloud Billing 帳戶?我需要支付應用程式費用嗎?
我們使用 Google Cloud Platform 執行各種幕後工作。建立 Earth Engine 應用程式不會產生費用。不過,Google Cloud Storage 不是免費服務,因此如果您選擇將分析結果匯出至 Google Cloud Storage,可能會產生相關費用。
如何進一步瞭解應用程式用量和配額?

如果超出配額,Earth Engine 可能會傳回 HTTP 429: Too Many Requests 錯誤。一般來說,這些錯誤會由 Earth Engine 用戶端程式庫處理,該程式庫會以指數輪詢包裝要求,重試查詢,直到成功為止。Earth Engine 用戶端程式庫會重試要求五次。

如果您的應用程式非常受歡迎,導致許多使用者收到配額超出錯誤,使用者就會看到警告訊息,Earth Engine 可能必須 (暫時) 限制對應用程式的存取權。

為避免收到 429 錯誤,建議您為應用程式啟用快取功能,例如將可快取的匯總統計資料儲存為 Earth Engine 表格資產,而非即時計算這些資料。