Earth Engine 앱은 Earth Engine 분석을 위한 동적이고 공유 가능한 사용자 인터페이스입니다. 앱을 사용하면 전문가가 간단한 UI 요소를 사용하여 Earth Engine의 데이터 카탈로그와 분석 기능을 활용할 수 있으며, 이를 전문가와 비전문가 모두 사용할 수 있습니다.
Earth Engine에서 게시된 앱은 게시 시 생성된 애플리케이션별 URL에서 액세스할 수 있습니다. 게시된 앱을 보거나 상호작용하기 위해 Earth Engine 계정은 필요하지 않습니다. 크리에이터가 추천으로 선택한 앱은 사용자별 앱 갤러리(예: USERNAME.users.earthengine.app).
앱 빌드
Earth Engine 앱은 몇 가지 예외를 제외하고 코드 편집기에서 사용되는 것과 동일한 함수 대부분을 활용할 수 있습니다. 또한 앱 개발자를 염두에 두고 사용자 인터페이스 API를 설계했습니다. 사용자 인터페이스 API를 처음 사용하는 경우
UI API 개요를 참고하세요.
앱 게시
Code Editor에서 앱을 게시하려면 먼저 앱으로 만들 스크립트를 로드한 다음 Code Editor의 스크립트 섹션 위에서 앱 버튼을 클릭하여 액세스할 수 있는 앱 관리 패널을 엽니다.
앱 관리 버튼
그런 다음 새 앱 버튼을 클릭합니다.
새 앱 버튼
대화상자에서 편집기 액세스 권한, 앱 이름을 선택하고 Google Cloud 프로젝트를 선택한 후 앱의 소스 코드 위치를 지정합니다. 이 앱에 대한 액세스를 특정 Google 그룹으로 제한하거나 제한 탭의 옵션을 사용하여 공개적으로 액세스할 수 있도록 합니다. 공개적으로 액세스할 수 있는 앱의 경우 갤러리 탭에 앱의 맞춤 미리보기 이미지와 설명을 제공할 수도 있습니다. 이 앱이 USERNAME.users.earthengine.app에서 제공되는 앱의 공개 갤러리에 표시되도록 하려면 '앱 갤러리에 이 앱 표시'를 클릭합니다. 원하는 경우 로고 탭에서 원하는 이미지를 업로드하여 앱 왼쪽 상단에 맞춤 로고를 포함합니다.
수정 액세스 권한 선택: 앱을 수정할 수 있는 사용자를 선택합니다.앱 게시: 이름, 앱 ID, Cloud 프로젝트를 선택합니다.앱 게시: 앱 소스 코드 선택
앱 게시: 갤러리에 앱 표시, 액세스 제한, 맞춤 로고와 같은 옵션 선택
앱 관리
코드 편집기에서 앱을 관리하려면 코드 편집기의 스크립트 섹션 위에 있는 앱 버튼을 클릭하여 앱 관리 패널을 엽니다. 여기에서 앱 구성을 업데이트하거나 앱을 삭제할 수 있습니다.
앱 관리
프로젝트 소유 앱에서 다른 사용자와 공동작업하기
기본적으로 사용자 이름으로 게시한 앱은 본인만 수정할 수 있습니다. 프로젝트 소유 앱을 사용하면 앱에서 공동작업을 할 수 있습니다. 프로젝트 소유 앱은 Cloud 프로젝트에서 소유하고 게시하는 앱입니다. Earth Engine Apps Publisher IAM 역할이 있는 사용자는 누구나 Cloud 프로젝트에서 게시된 앱을 수정하고 삭제할 수 있습니다.
여기에서 Earth Engine IAM 역할 자세히 알아보기
프로젝트 소유 앱을 사용 설정하려면 '수정 액세스 권한 선택' 단계에서 Cloud 프로젝트 옵션을 선택하고 사용할 Cloud 프로젝트를 선택한 다음 평소와 같이 앱 게시 흐름을 완료합니다. 앱은 PROJECT-ID.projects.earthengine.app 도메인에 게시되며 Cloud 프로젝트에서 Earth Engine Apps 게시자 IAM 역할을 가진 모든 사용자가 수정할 수 있습니다.
프로젝트 소유 앱 게시
Cloud 프로젝트의 앱을 보려면 ADD CLOUD PROJECT(Cloud 프로젝트 추가) 버튼을 누르고 Cloud 프로젝트를 선택합니다.
Cloud 프로젝트 추가
클라우드 프로젝트를 다른 사용자와 공유하려면 프로젝트 공유 버튼을 누릅니다.
그러면 공동작업자에게 Earth Engine Apps 게시자 IAM 역할을 부여할 수 있는 프로젝트의 Cloud Console IAM 페이지로 이동합니다.
프로젝트 소유 앱 수정 및 삭제
FAQ
앱 갤러리에서 앱을 삭제하려면 어떻게 해야 하나요?
앱 구성 페이지의 '이 앱 추천' 체크박스는 앱이 추천 앱 페이지에 표시되는지 여부를 제어합니다. 액세스가 제한된 앱은 추천할 수 없습니다.
Earth Engine 코드가 표시되나요?
예. 앱에 액세스할 수 있는 모든 사용자가 볼 수 있습니다. 앱이 게시될 때는 명확하게 표시되지 않지만 누구나 웹브라우저의 네트워크 트래픽을 관찰하여 앱의 JavaScript를 쉽게 볼 수 있습니다. 예를 들어 Chrome에서는 개발자 도구의
네트워크 패널을 보면 JavaScript가 표시됩니다.
게시된 앱에서 '지도의 일부를 로드하는 중에 오류가 발생했습니다' 오류가 발생하는 이유는 무엇인가요?
앱에서 사용되는 모든 이미지 또는 표 애셋이 공개적으로 또는 앱과 공유되어 있는지 확인합니다. 애셋 공유 대화상자에서 '모든 사용자에게 읽기 권한 제공' 옵션을 선택하거나 드롭다운 목록에서 앱 이름을 선택합니다. Google 그룹으로 제한된 앱의 경우 해당 Google 그룹과 애셋을 공유해도 앱에서 볼 수 없습니다. 대신 애셋을 앱과 공유하거나 공개적으로 공유해야 합니다.
'앱이 아직 준비되지 않음' 페이지가 표시되는 이유는 무엇인가요?
앱이 생성된 후 정보가 시스템을 통해 전파되는 데 다소 시간이 걸릴 수 있습니다. 이 문제는 일반적으로 몇 분 이내에 해결됩니다. 오류가 계속되면 도움을 요청하세요.
그려진 도형이 앱에 표시되는 이유는 무엇인가요?
이렇게 하면 앱에 참조 도형을 쉽게 표시할 수 있으며 사용자가 도형을 수정할 수 있는 앱을 만들 수 있습니다. 특정 도형이 표시되거나 수정되지 않도록 하려면 앱을 게시하기 전에 개별 도형 레이어를 숨기거나 잠그면 사용자가 이를 보거나 수정하지 못하도록 할 수 있습니다. 자세한 내용은
도형 도구 문서를 참고하세요.
앱 할당량이란 무엇인가요?
오류가 있거나 리소스 집약적인 스크립트가 서비스 가용성에 부정적인 영향을 미치지 않도록 Earth Engine에는 동시 쿼리에 대한 앱 사용량 할당량이 있습니다. 이 할당량은 특정 사용자 대신 앱에 연결된다는 점을 제외하고 Earth Engine의
사용자별 할당량과 유사하게 작동합니다.
내가 만드는 각 앱에 자체 할당량이 있나요?
예. 각 앱에 별도의 할당량이 연결됩니다. API 키로 만든 이전 앱의 경우 할당량은 앱의 API 키를 생성하는 Cloud 프로젝트에 연결됩니다.
동일한 Cloud 프로젝트에서 여러 API 키를 생성하면 모두 동일한 사용량 할당량을 공유합니다.
Cloud Billing 계정이 필요한 이유는 무엇인가요? 앱 요금이 청구되나요?
YouTube는 다양한 백엔드 작업에 Google Cloud Platform을 사용합니다. Earth Engine 앱을 만드는 데는 요금이 청구되지 않습니다. 하지만 Google Cloud Storage는 무료가 아니므로 분석 결과를 Google Cloud Storage로 내보내기로 선택하면 관련 수수료가 청구될 수 있습니다.
앱 사용량과 할당량을 더 잘 이해하려면 어떻게 해야 하나요?
할당량을 초과하면 Earth Engine에서 HTTP 429: Too Many Requests 오류를 반환할 수 있습니다. 일반적으로 이러한 오류는 지수 백오프로 요청을 래핑하고 쿼리가 성공할 때까지 쿼리를 재시도하는 Earth Engine 클라이언트 라이브러리에서 처리합니다. Earth Engine 클라이언트 라이브러리는 요청을 5번 재시도합니다.
앱이 인기를 얻어 많은 사용자에게 할당량 초과 오류가 발생하면 사용자에게 경고 메시지가 표시되고 Earth Engine에서 앱에 대한 액세스를 일시적으로 제한해야 할 수 있습니다.
429 오류가 발생하지 않도록 하려면 애플리케이션에서 캐싱을 사용 설정하는 것이 좋습니다. 예를 들어 캐시 가능한 집계 통계를 실시간으로 계산하는 대신 Earth Engine 테이블 애셋으로 저장할 수 있습니다.
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eEarth Engine Apps are interactive interfaces built with simple UI elements to analyze and visualize Earth Engine data, accessible via a unique URL without requiring an Earth Engine account.\u003c/p\u003e\n"],["\u003cp\u003eTo build an App, users can leverage Earth Engine functions and the UI API, ensuring any used image or table assets are shared publicly for proper display.\u003c/p\u003e\n"],["\u003cp\u003eApps can be managed and published through the Code Editor's App Management panel, with options to control access, customize appearance, and feature in a user-specific App Gallery.\u003c/p\u003e\n"],["\u003cp\u003eCollaboration is enabled through Project-owned Apps, allowing multiple users with the 'Earth Engine Apps Publisher' IAM role to edit and manage Apps associated with a Cloud Project.\u003c/p\u003e\n"],["\u003cp\u003eEarth Engine Apps have usage quotas to prevent overuse, with each App having its own quota and potential for exceeding limits during high traffic; caching and optimizing App logic can help mitigate this.\u003c/p\u003e\n"]]],["Earth Engine Apps enable sharing interactive analyses. To publish, load a script in the Code Editor, open the App Management panel, and create a new app. Configure access restrictions (public or Google Group), add a preview image, description, and custom logo. Apps can be project-owned for collaboration. Asset sharing must be public or with the App for it to display. Apps have usage quotas to avoid resource issues, and excess quota will trigger HTTP 429 errors.\n"],null,["# Earth Engine Apps\n\nIntroduction\n------------\n\n\nEarth Engine Apps are dynamic, shareable user\ninterfaces for Earth Engine analyses. With Apps, experts can use simple UI elements to\nleverage Earth Engine's data catalog and analytical power, for experts and non-experts alike\nto use.\n\n\nApps published from Earth Engine are accessible from the\napplication-specific URL generated at time of publishing. No Earth Engine account is\nrequired to view or interact with a published App. Apps selected as featured by their\ncreator are also available at a user-specific App Gallery\n(e.g., USERNAME.users.earthengine.app).\n**Note:** Access to a published App can be restricted to members of a Google Group, or it can be made publicly accessible. Publicly accessible Apps are viewable by anyone, without needing to sign in. If an App is restricted to members of a Google Group, users will need to sign in to an account that is a member of the group. \n\nBuild Your App\n--------------\n\nEarth Engine Apps can take advantage of most of the same functions used in the Code Editor,\nwith a few exceptions. Additionally, we designed the User Interface API with Apps developers\nin mind. If you're new to the User Interface API, take a look at [the UI API Overview](/earth-engine/ui).\n**Important:** Any image or table assets used in your App must be shared publicly for the App to display properly. In the [share dialog](/earth-engine/asset_manager#sharing-assets), select the \"Anyone can read\" option or choose the App name from the drop-down list. \n\nPublishing Your App\n-------------------\n\n\nTo publish an App from the Code Editor, first load the script that you want to make into\nan App, and then open the App Management panel, which you can access by clicking the\n**Apps** button above the script section in the Code Editor.\nManage Apps Button\n\n\u003cbr /\u003e\n\n\nThen click on the **NEW APP** button.\nNew App Button\n\n\u003cbr /\u003e\n\n\nIn the dialog, choose editor access, an App name, select a Google Cloud Project, and specify\nthe location of the App's source code. Restrict access to this App to a particular Google\nGroup or keep it publicly accessible using options under the Restriction tab. For publicly\naccessible apps, you can also provide a custom preview image for the App as well as a\ndescription in the Gallery tab. Click \"Feature this app in your Apps Gallery\" if you would\nlike this App to appear on your public gallery of apps available at\n`USERNAME.users.earthengine.app`. Optionally include a custom logo in the\nupper-left corner of the App by uploading an image of your choice from the Logo tab.\n\n| **Note:** only a single Google Group can be given access. However, a Google Group can have additional Google Groups as members. [Learn about Google Groups](https://support.google.com/groups/).\n| **Note:** If you have not used Google Cloud Projects before we recommend creating a project called \"ee-USERNAME\". This same Google Cloud Project can be used for all your Apps. You may also need to select an organization if you have an institutional account. [Learn about Google Cloud Projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects).\nChoose editing access: choose who can edit the app. Publish an App: choose a name, App ID, and Cloud Project. Publish an App: select the App source code Publish an App: choose options like featuring the App in your gallery, access restrictions, and custom logo \n\nManaging Your Apps\n------------------\n\n\nTo manage an App from the Code Editor, open the App Management panel by clicking the\n**Apps** button above the script section in the Code Editor. From here you can update\nyour App's configuration or delete the app.\nManage Apps\n\nCollaborate with others on Project-owned Apps\n---------------------------------------------\n\n\nBy default, Apps that you publish under your username are only editable by you. Collaboration\non Apps is possible with *Project-owned Apps* . Project-owned Apps are apps that are\nowned and published under a Cloud Project; anyone with the\n*Earth Engine Apps Publisher* IAM role can edit and delete apps published under the\nCloud Project.\n[Learn more\nabout Earth Engine IAM Roles here](/earth-engine/cloud/roles_permissions#predefined-earth-engine-iam-roles).\n| **Important:** Deleting a Cloud Project will also result in the deletion of any Project-owned Apps under the Cloud Project, as per [Google Cloud's data deletion and\n| retention policies](https://cloud.google.com/docs/security/deletion).\n\n\nTo enable Project-owned Apps, choose the *Cloud Project* option on the\n\"Choose editing access\" step and select the Cloud Project you would like to use, then finish\nthe App publishing flow as normal. The App will be published to the domain\n`PROJECT-ID.projects.earthengine.app` and will be editable by anyone who has the\nEarth Engine Apps Publisher IAM role on the Cloud Project.\nPublish a Project-owned App\n\n\nTo view Apps for a Cloud Project, press the **ADD CLOUD PROJECT** button and\nselect the Cloud Project.\nAdd a Cloud Project\n\n\nTo share the Cloud Project with others, press the **SHARE PROJECT** button.\nThis will take you to the Cloud Console IAM page for the project where you can grant\ncollaborators the Earth Engine Apps Publisher IAM role.\nEdit and delete Project-owned Apps\n\nFAQ\n---\n\nHow do I remove an App from my Apps Gallery?\n:\n The \"Feature this App\" checkbox on the App configuration page controls whether or not an App\n appears on the Featured Apps page. Apps with restricted access cannot be featured.\n\n\nIs my Earth Engine code visible?\n:\n Yes, to anyone who can access the App. Although it's not clearly visible when your app is\n published, it's fairly easy for\n someone to view the JavaScript for your App by watching the network traffic to their web\n browser. In Chrome, for example, the JavaScript will be visible by looking at the\n [Network panel](https://developers.google.com/web/tools/chrome-devtools/network-performance/reference) of the Developer Tools.\n\n\nWhat are some possible causes of the \"There was an error loading some parts of the map\"\nerror for a published App?\n: Ensure all image or table assets used in your App are shared publicly or with the App. In\n the [asset share dialog](/earth-engine/asset_manager#sharing-assets),\n select the \"Anyone can read\" option or choose the App name from the drop-down list. For apps\n restricted to a Google Group, sharing an asset with that Google Group\n will **not** make it viewable by the App; the assets should be shared with the\n App or publicly, instead.\n\n\nWhy do I see an \"app is not ready yet\" page?\n:\n After an App is created, it may take some time for information to propagate through the\n system. This is typically resolved within a few minutes. If the error persists, please\n [reach out for help](https://developers.google.com/earth-engine/help).\n\n\nWhy are my drawn geometries shown in my App?\n:\n This makes it easy to show reference geometries in your App, and allows you to create Apps\n where users can edit the geometries. If you don't want particular geometries to be shown or\n edited, you can hide or lock individual geometry layers to prevent users from seeing or\n editing them before publishing your App. See the\n [geometry tools documentation](https://developers.google.com/earth-engine/playground#geometry-tools) to learn more.\n\n\nWhat is App quota?\n:\n To prevent errant or resource-intensive scripts from negatively impacting the availability of\n the service, Earth Engine has App usage quotas on concurrent queries. This quota operates\n similarly to Earth Engine's [per-user quota](https://developers.google.com/earth-engine/usage), except that the quota is tied to a the App, rather than a specific\n user.\n\n\nDoes each App I make have its own quota?\n:\n Yes, separate quota is associated with each App. For older apps created with an\n API Key, quota is tied to the Cloud Project from which you generate an App's API key.\n If you generate multiple API keys from the same Cloud Project, they will all share the\n same usage quota.\n\nWhy is a Cloud billing account required? Will I be charged for my apps?\n:\n We use Google Cloud Platform for a variety of behind-the-scenes tasks. You will not be\n charged for creating an Earth Engine App. However, Google Cloud Storage is not free,\n so if you choose to export the results of your analyses to Google Cloud Storage,\n there may be an associated fee.\n\n\nHow can I understand my apps usage and quota better?\n\n: If the quota is exceeded, Earth Engine may return `HTTP 429: Too Many Requests`\n errors. Generally, these errors are handled by the Earth Engine client library, which\n wraps requests in exponential backoff, retrying the query until it succeeds. The Earth\n Engine client library will retry the request five times.\n\n If your app becomes so popular that many users get quota exceeded errors, users will see\n a warning message, and Earth Engine may have to (temporarily) restrict access to the app.\n\n To help avoid receiving 429 errors, you may want to enable caching for your application,\n such as by storing cacheable aggregate statistics as Earth Engine table assets,\n rather than computing them on the fly."]]
