Earth Engine 액세스

Earth Engine은 Google Cloud에서 실행되며 액세스 및 API 관리를 위해 Cloud 프로젝트가 필요합니다. 모든 Earth Engine 호출 (Code Editor, 클라이언트 라이브러리, 앱 또는 REST API)은 Cloud 프로젝트를 통해 라우팅되므로 Cloud Console에서 액세스 제어, 리소스 관리, 사용량 모니터링을 할 수 있습니다.

Earth Engine 액세스 권한 얻기

Earth Engine을 사용하려면 다음과 같은 Cloud 프로젝트에 액세스할 수 있어야 합니다.

프로젝트 만들기

등록 페이지를 방문하여 새 Cloud 프로젝트를 만들고 등록하거나 기존 프로젝트를 등록합니다.

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

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

클라우드 프로젝트 만들기

아직 만들지 않았다면 Google Cloud 프로젝트를 만듭니다. Cloud Console의 프로젝트 페이지에서 또는 다음 버튼을 클릭하여 프로젝트를 만들 수 있습니다.

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/

애셋 패널에서 프로젝트를 추가하여 Code Editor에서 프로젝트의 애셋 폴더를 만들 수도 있습니다.

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

기존 프로젝트 사용

Earth Engine에 구성된 기존 Cloud 프로젝트에 관해 조직의 IT 담당자에게 문의합니다. Earth Engine 서비스에 액세스하는 데 사용할 Google 계정에 프로젝트에 대한 올바른 역할과 권한이 부여되었는지 확인합니다.

프로젝트 지정

다음 섹션에서는 Earth Engine 서비스의 다양한 인터페이스에 프로젝트를 지정하는 방법을 설명합니다.

클라이언트 라이브러리 (Python, JavaScript)

ee.Initialize() 함수는 Python 및 JavaScript 클라이언트 라이브러리에서 발생하는 Earth Engine 요청의 프로젝트를 지정하는 데 사용됩니다. 프로젝트 사양을 구성하는 방법에는 여러 가지가 있습니다. 자세한 내용은 인증 및 초기화 페이지를 참고하세요.

코드 편집기

Code Editor의 오른쪽 상단에 있는 프로필 아이콘을 클릭하고 메뉴에서 '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 프로젝트는 Cloud IAM을 사용하여 역할과 권한을 관리합니다. 다른 사용자가 내 프로젝트를 통해 Earth Engine에 액세스하려면 Cloud 콘솔을 사용하여 올바른 역할 및 권한을 부여해야 합니다.

OAuth 2.0 클라이언트 ID

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

프로젝트의 새 클라이언트 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 계정을 삭제하면 연결된 Earth Engine 데이터 전체가 약 30일 이내에 삭제됩니다.

데이터가 삭제되면 Earth Engine팀에서 복구할 수 없습니다.

Cloud 프로젝트

Cloud 프로젝트가 삭제되면 해당 프로젝트와 연결된 Earth Engine 데이터(예: 프로젝트 루트에 저장된 애셋, 프로젝트 수준 EE 앱, 모니터링 데이터 등)가 삭제됩니다. 이 절차는 최대 30일 동안 되돌릴 수 있지만 30일 후에는 데이터를 복구할 수 없습니다.

애셋

애셋을 삭제하는 가장 간단한 방법은 Code Editor의 '애셋' 탭을 사용하여 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')

자바스크립트 클라이언트

Code Editor의 보안 샌드박스로 인해 이 호출이 해당 환경에서 작동하지 않습니다.

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

명령줄 도구

rm 명령어를 사용합니다.

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

코드 편집기 스크립트

Earth Engine Code Editor 스크립트를 삭제하려면 다음 단계를 따르세요.

코드 편집기

Code 편집기의 '스크립트' 탭에서 스크립트 또는 저장소를 선택하고 삭제합니다. 저장소가 삭제된 것으로 표시되면 30일 이내에 복구할 수 없습니다.

Git 사용

고급 사용자는 Git을 사용하여 스크립트를 관리할 수 있습니다. 볼 수 있는 저장소 목록은 https://earthengine.googlesource.com/을 참고하세요.

Earth Engine 앱

Earth Engine 앱을 삭제하려면 코드 편집기의 '앱' 버튼을 사용하여 앱을 관리하세요.

링크 관리 페이지를 사용하여 코드 편집기에서 '링크 가져오기' 링크를 확인하고 삭제할 수 있습니다. 이 페이지는 '링크 가져오기' 버튼 옆에 있는 드롭다운 메뉴의 '링크 관리' 옵션으로 이동하여 찾을 수 있습니다.

상업적 액세스 종료

Earth Engine의 직접 고객이며 유료 컨텍스트에서 Earth Engine 사용을 중지하려는 경우 요금이 청구되지 않도록 하려면 몇 가지 사항을 변경해야 합니다.

  • 정기 결제 청구 중지하기

    • 결제 계정에서 Earth Engine 구독을 해지하려면 '요금제 관리' 페이지를 사용해야 합니다 (해당 결제 계정에 연결된 등록된 Cloud 프로젝트를 사용하는 경우 Code 편집기 오른쪽 상단의 사용자 설정 드롭다운 메뉴에서 액세스할 수 있음).

    • 결제 계정의 '계획 관리' 페이지에 직접 액세스할 수도 있습니다.

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

    • '제한적' 요금제를 선택하면 현재 결제 주기가 종료된 후 결제 계정에 Earth Engine 플랫폼 정기 결제 요금이 더 이상 청구되지 않습니다.

  • 컴퓨팅 요금 중지하기

    • 컴퓨팅(EECU 시간)과 관련된 새로운 요금이 청구되지 않도록 하려면 Cloud 프로젝트에서 Earth Engine API를 사용 중지하세요. 이렇게 해도 진행 중인 요청이 종료되거나 저장된 객체가 삭제되지 않으므로 API를 사용 중지해도 Earth Engine 요금이 청구될 수 있습니다.
    • API 사용 중지에 관한 자세한 내용은 API Console 도움말을 참고하세요.

  • 스토리지 요금 중지하기

    • 저장된 Earth Engine 애셋은 API가 사용 중지되더라도 계속 비용이 발생합니다. 확장 소재를 삭제하면 더 이상 EE 스토리지 요금이 청구되지 않습니다.