Earth Engine は Google Cloud で実行され、アクセスと API 管理に Cloud プロジェクトが必要です。すべての Earth Engine 呼び出し(コードエディタ、クライアント ライブラリ、アプリ、REST API からの呼び出しを含む)は Cloud プロジェクトを介してルーティングされるため、Cloud Console でアクセス制御、リソース管理、使用状況のモニタリングを行うことができます。
Earth Engine へのアクセス権を取得する
Earth Engine を使用するには、次の条件を満たす Cloud プロジェクトにアクセスする必要があります。
プロジェクトを作成する
登録ページにアクセスして、新しい Cloud プロジェクトを作成して登録するか、既存のプロジェクトを登録します。登録後、Earth Engine へのアクセスはすぐに有効になります。
登録プロセス中に作成されたプロジェクトは、 Google Cloud コンソールで管理できます。Earth Engine API は、 Cloud Console の Earth Engine API ページで有効または無効にできます。
手動の手順(登録ページで自動化)
Cloud プロジェクトを作成する
まだ作成していない場合は、 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
アセット フォルダを作成する(省略可)
こちらで説明されているパスを使用して、アクセス権のある Cloud プロジェクトに関連付けられた Earth Engine アセット フォルダを作成できます。これには、
earthengine create folder
コマンドを使用します。次に例を示します。
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 プロジェクトに関連付けるには、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 プロジェクトの認証情報を管理するには、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
一般的な使用方法
教育クラスを教えています。
これで完了です。非営利プロジェクトを登録する場合は、請求先アカウントの設定は必要ありません。その後、生徒をプロジェクトに追加できます。
運用チーム/商用組織の一員である...
これで完了です。商用利用のプロジェクトを登録し、共同編集者をプロジェクトに追加できます。選択した Earth Engine サブスクリプションのユーザー数の上限にもご注意ください。
Earth Engine データの削除
アカウント単位の削除
アカウント レベルの削除を行うと、アカウントから すべての Earth Engine データが削除されます。
アカウントが Google Workspace 組織に属している場合、アカウント データは管理者が管理します。管理者が Google アカウントを削除すると、関連付けられている Earth Engine のすべてのデータが約 30 日以内に消去されます。
削除されたデータを Earth Engine チームが復元することはできません。
Cloud プロジェクト
Cloud プロジェクトが削除されると、そのプロジェクトに関連付けられている Earth Engine データ(プロジェクト ルートに保存されているアセット、プロジェクト レベルの EE Apps、モニタリング データなど)の削除がトリガーされます。このプロセスは 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 コードエディタ スクリプトを削除するには:
コードエディタ
コードエディタの [Scripts] タブで、スクリプトまたはリポジトリを選択して削除します。リポジトリが削除済みとしてマークされると、30 日以内に復元できなくなります。
Git の使用
上級ユーザーは、Git を使用してスクリプトを管理できます。表示できるリポジトリの一覧については、https://earthengine.googlesource.com/ をご覧ください。
Earth Engine アプリ
Earth Engine アプリを削除するには、コードエディタの [Apps] ボタンを使用してアプリを管理します。
「リンクを取得」の参照
[リンクを管理] ページを使用して、コードエディタから [リンクを取得] リンクを表示および削除します。このページを表示するには、[リンクを取得] ボタンの横にあるプルダウン メニューの [リンクを管理] オプションに移動します。
非営利目的のアクセスを構成する
プロジェクトの非商用(無償)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 サブスクリプションを終了するには、[プランの管理] ページを使用する必要があります(このページには、その請求先アカウントにリンクされている登録済みの Cloud プロジェクトを使用しているときに、Code Editor の右上にあるユーザー設定のプルダウン メニューからアクセスできます)。
請求先アカウントの [プランの管理] ページに直接アクセスすることもできます。
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 ストレージ料金の発生が停止します。