Earth Engine へのアクセス

Earth Engine は Google Cloud 上で実行され、アクセスと API 管理には Cloud プロジェクトが必要です。Earth Engine の呼び出しはすべて（コードエディタ、クライアント ライブラリ、アプリ、REST API のいずれからでも）、クラウド プロジェクトを介してルーティングされるため、Cloud コンソールでアクセス制御、リソース管理、使用状況のモニタリングを行うことができます。

Earth Engine へのアクセス権を取得する

Earth Engine を使用するには、次の条件を満たすクラウド プロジェクトへのアクセス権が必要です。

プロジェクトを作成する

登録ページにアクセスして、新しいクラウド プロジェクトを作成して登録するか、 既存のプロジェクトを登録します。登録すると、Earth Engine へのアクセスがすぐに有効になります。

登録プロセスで作成されたプロジェクトは、 Google Cloud コンソール で管理できます。Earth Engine API の有効化または無効化は、 Cloud Console の Earth Engine API ページから行えます。

手動の手順（登録ページで自動化）

クラウド プロジェクトを作成する

まだ作成していない場合は、 Google Cloud プロジェクトを作成します。Cloud Console の [プロジェクト] ページ から作成するか、次のボタンをクリックします:

クラウド プロジェクトを作成する

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

アセット フォルダを作成する（省略可）

アクセス権がある Cloud プロジェクトに関連付けられた Earth Engine アセット フォルダを作成するには、ここで説明されているパスを使用して earthengine create folder コマンドを使用します here。 次に例を示します。 

earthengine create folder projects/my-project/assets/

また、[アセット] パネルでプロジェクトを追加して、コードエディタでプロジェクトのアセット フォルダを作成することもできます。

プロジェクトにアセットを保存する予定がない場合は、このフォルダを作成する必要はありません。

既存のプロジェクトを使用する

Earth Engine 用に構成された既存の Cloud プロジェクトについては、組織の IT スタッフにお問い合わせください。Earth Engine サービスへのアクセスに使用する Google アカウントに、プロジェクトに対する適切なロールと権限が付与されていることを確認してください。

プロジェクトを指定する

以降のセクションでは、Earth Engine サービスのさまざまなインターフェースでプロジェクトを指定する方法について説明します。

クライアント ライブラリ（Python、JavaScript）

ee.Initialize() 関数は、Python クライアント ライブラリとJavaScript クライアント ライブラリから送信される Earth Engine リクエストのプロジェクトを指定するために使用されます。プロジェクトの指定を構成する方法はいくつかあります。詳細については、 認証と初期化のページをご覧ください。

コードエディタ

コードエディタの右上にあるプロフィール アイコンをクリックし、メニューから [Change Cloud Project] を選択します。選択ダイアログからプロジェクトを選択します。

Earth Engine アプリ

Earth Engine アプリを公開するときに、リクエストのルーティングに使用する プロジェクトを選択するよう求められます。公開ダイアログの手順に沿って操作してください。

コマンドライン ツール

コマンドライン ツールからの Earth Engine 呼び出しを Cloud プロジェクトに関連付けるには、--project パラメータを earthengine の呼び出しで使用するか、set_project を使用してデフォルト プロジェクトを設定します。

REST API

REST API の呼び出しをクラウド プロジェクトに関連付けるには、認証が 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 Console を使用して 適切なロールと権限を付与する必要があります。

OAuth 2.0 クライアント ID

たとえば、ユーザー認証情報を Earth Engine に渡すアプリを作成するには、プロジェクトから OAuth 2.0 クライアント ID を作成する必要があります。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 アカウントを削除すると、関連付けられているすべての 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')

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 Console で登録アンケートに回答して、プロジェクトの利用資格を確認する必要があります。

確認

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 Console ヘルプをご覧ください。

  • ストレージの課金を停止する

    • API が無効になっていても、保存されている Earth Engine アセットは引き続き費用が発生します。アセットを削除すると、 EE ストレージ料金が課金されなくなります。