Earth Engine 액세스

Earth Engine은 Google Cloud에서 실행되며 액세스 및 API 관리를 위해 Cloud 프로젝트가 필요합니다. 모든 Earth Engine 호출(코드 편집기, 클라이언트 라이브러리, 앱 또는 REST API에서 발생)은 Cloud 프로젝트를 통해 라우팅되므로 Cloud 콘솔에서 액세스 제어, 리소스 관리, 사용량 모니터링이 가능합니다.

Earth Engine 액세스 권한 얻기

Earth Engine을 사용하려면 다음을 충족하는 Cloud 프로젝트에 액세스해야 합니다.

프로젝트 만들기

등록 페이지를 방문하여 새 Cloud 프로젝트를 만들고 등록하거나 기존 프로젝트를 등록합니다. 등록 후 Earth Engine 액세스가 즉시 사용 설정됩니다.

등록 과정에서 생성된 프로젝트는 Google Cloud 콘솔에서 관리할 수 있습니다. Cloud 콘솔의 Earth Engine API 페이지에서 Earth Engine API를 활성화 또는 비활성화할 수 있습니다.

수동 단계(등록 페이지에서 자동화됨)

클라우드 프로젝트 만들기

아직 만들지 않았다면 Google Cloud 프로젝트를 만듭니다. Cloud 콘솔의 프로젝트 페이지에서 이 작업을 수행하거나 다음 버튼을 클릭하면 됩니다.

Cloud 프로젝트 만들기

Earth Engine API 사용 설정

프로젝트에 Earth Engine API를 사용 설정하려면 다음 버튼을 클릭하여 Earth Engine API 페이지로 이동합니다.

Earth Engine API 사용 설정

Earth Engine API 페이지에서 프로젝트를 선택했는지 확인하고 사용 설정 버튼을 클릭합니다.

상업용 또는 비상업용으로 프로젝트 등록

프로젝트의 다음 URL을 수정하고 페이지를 방문하여 등록 과정을 완료합니다.

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

애셋 폴더 만들기(선택사항)

여기에 설명된 경로를 사용하여 earthengine create folder 명령어를 통해 액세스 권한이 있는 Cloud 프로젝트와 연결된 Earth Engine 애셋 폴더를 만들 수 있습니다. 예를 들면 다음과 같습니다.

earthengine create folder projects/my-project/assets/

애셋 패널에서 프로젝트를 추가하여 코드 편집기에서 프로젝트의 애셋 폴더를 만들 수도 있습니다.

프로젝트에 애셋을 저장할 계획이 없으면 이 폴더를 만들 필요가 없습니다.

기존 프로젝트 사용

조직의 IT 직원에게 Earth Engine용으로 구성된 기존 Cloud 프로젝트가 있는지 확인합니다. 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 프로젝트와 연결하려면 oauth2에서 인증을 처리하는 인증된 HTTP 호출을 실행합니다. 로컬 환경에서는 gcloud 명령어를 사용할 수 있습니다. Cloud 프로젝트와 연결된 서비스 계정을 사용할 수도 있습니다. google.oath.service_account.Credentials.from_service_account_file()를 사용하여 서비스 계정으로 인증하는 예시는 REST API 빠른 시작을 참조하세요.

프로젝트 액세스 구성

다음 섹션에서는 다른 개인 및 서비스 계정에서 사용할 수 있도록 Earth Engine 지원 프로젝트를 구성하는 방법을 설명합니다.

서비스 계정

서비스 계정은 상위 프로젝트가 등록되고 Earth Engine API가 사용 설정되면 자동으로 액세스 권한을 갖습니다. 또한 프로젝트 내에서 올바른 권한이 필요합니다. 프로젝트의 서비스 계정은 원하는 수만큼 Earth Engine을 사용하도록 구성할 수 있습니다. Earth Engine에서 서비스 계정을 사용하는 방법에 대한 자세한 내용은 서비스 계정 페이지를 참조하세요.

Google 계정

클라우드 프로젝트는 Cloud IAM을 사용하여 역할과 권한을 관리합니다. 다른 사용자가 프로젝트를 통해 Earth Engine에 액세스할 수 있도록 하려면 Cloud 콘솔을 사용하여 올바른 역할 및 권한을 부여해야 합니다.

OAuth 2.0 클라이언트 ID

예를 들어 사용자 인증 정보를 Earth Engine에 전달하는 앱을 만들려면 프로젝트에서 OAuth 2.0 클라이언트 ID를 만들어야 할 수 있습니다. Cloud 콘솔 메뉴()로 이동하고 API 및 서비스 > 사용자 인증 정보를 선택하여 Cloud 프로젝트의 사용자 인증 정보를 관리할 수 있습니다. (메시지가 표시되면 프로젝트를 선택합니다.)

프로젝트의 새 클라이언트 ID를 만들려면 + 사용자 인증 정보 만들기 > OAuth 클라이언트 ID > 웹 애플리케이션을 클릭합니다.

웹 애플리케이션 구성에서 다음을 수행합니다.

  • 승인된 자바스크립트 출처를 지정합니다. 예를 들면 다음과 같습니다.
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 계정을 삭제하면 연결된 모든 Earth Engine 데이터가 약 30일 이내에 완전 삭제됩니다.

Earth Engine팀은 데이터가 삭제된 후에는 복구할 수 없습니다.

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')

자바스크립트 클라이언트

코드 편집기의 보안 샌드박스는 이 호출이 해당 환경에서 작동하지 않도록 합니다.

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 구독을 종료하려면 '요금제 관리' 페이지를 사용해야 합니다. 이 페이지는 해당 결제 계정에 연결된 등록된 클라우드 프로젝트를 사용할 때 코드 편집기 오른쪽 상단의 사용자 설정 드롭다운 메뉴에서 액세스할 수 있습니다.
    • 결제 계정의 '요금제 관리' 페이지에 직접 액세스할 수도 있습니다.

      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 스토리지 요금이 발생하지 않습니다.