Earth Engine は Google Cloud 上で動作し、アクセスと API 管理のためにクラウド プロジェクトが必要です。すべての Earth Engine 呼び出し(コードエディタ、クライアント ライブラリ、アプリ、REST API のいずれからでも)はクラウド プロジェクトを介してルーティングされるため、Cloud コンソールでアクセス制御、リソース管理、使用状況のモニタリングを行うことができます。
Earth Engine へのアクセス権を取得する
Earth Engine を使用するには、次の条件を満たすクラウド プロジェクトにアクセスする必要があります。
プロジェクトを作成する
登録ページにアクセスして、新しいクラウド プロジェクトを作成して登録するか、既存のプロジェクトを登録します。登録すると、Earth Engine へのアクセスがすぐに有効になります。
登録プロセス中に作成されたプロジェクトは、Google Cloud コンソールで管理できます。Earth Engine API は、Cloud コンソールの Earth Engine API ページで有効または無効にできます。
手動の手順(登録ページで自動化)
Cloud プロジェクトを作成する
まだ作成していない場合は、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/コードエディタでプロジェクトのアセット フォルダを作成するには、[アセット] パネルでプロジェクトを追加します。
プロジェクトにアセットを保存する予定がない限り、このフォルダを作成する必要はありません。
既存のプロジェクトを使用する
Earth Engine 用に構成されている既存のクラウド プロジェクトについては、組織の IT スタッフに確認してください。Earth Engine サービスへのアクセスに使用する Google アカウントに、プロジェクトに対する適切なロールと権限が付与されていることを確認します。
プロジェクトを指定する
以降のセクションでは、Earth Engine のサービスへのさまざまなインターフェースにプロジェクトを指定する方法について説明します。
クライアント ライブラリ(Python、JavaScript)
ee.Initialize() 関数は、Python クライアント ライブラリと JavaScript クライアント ライブラリから送信される Earth Engine リクエストのプロジェクトを指定するために使用されます。プロジェクト仕様を構成する方法はいくつかあります。詳細については、認証と初期化のページをご覧ください。
コードエディタ
コードエディタの右上にあるプロフィール アイコンをクリックし、メニューから [クラウド プロジェクトを変更] を選択します。選択ダイアログからプロジェクトを選択します。
Earth Engine アプリ
Earth Engine アプリを公開するときに、リクエストをルーティングするプロジェクトを選択するよう求められます。公開ダイアログの手順に沿って操作します。
コマンドライン ツール
コマンドライン ツールからの Earth Engine 呼び出しをクラウド プロジェクトに関連付けるには、earthengine の呼び出しで --project パラメータを使用するか、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 コンソールを使用して、適切なロールと権限を付与する必要があります。
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 プロジェクト
クラウド プロジェクトが削除されると、そのプロジェクトに関連付けられている Earth Engine データ(プロジェクト ルートに保存されているアセット、プロジェクト レベルの EE アプリ、Monitoring データなど)の削除がトリガーされます。このプロセスは最長 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 サブスクリプションを解除するには、[プランの管理] ページを使用する必要があります(その請求先アカウントにリンクされている登録済みのクラウド プロジェクトを使用している場合は、コードエディタの右上にあるユーザー設定のプルダウン メニューからアクセスできます)。
請求先アカウントの [プランの管理] ページに直接アクセスすることもできます。
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 ストレージ料金が発生しなくなります。