Earth Engine は、共有コンピューティングリソースを保護し、すべてのユーザーに信頼性の高いパフォーマンスを提供するために、非商用割り当て階層を導入しています。非商用プロジェクトではデフォルトでコミュニティティアが使用されますが、プロジェクトのティアはいつでも変更できます。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Earth Engine コードエディタの AI アシスタント

Earth Engine コードエディタの [質問] パネルでは、Gemini を使用して、スクリプトの作成、理解、デバッグ、最適化を支援します。これは、地理空間分析とスクリプト開発を効率化するために、コードエディタに直接統合された会話型 AI アシスタントとして機能します。

インターフェースとツール

AI アシスタントパネルは、Earth Engine コードエディタの右側のペインにあります。開くには、[インスペクタ]、[コンソール]、[タスク] の各タブの横にある [質問] タブをクリックします。

[質問] ペインには、AI とのやり取りを管理するためのコントロールとツールがいくつか用意されています。

ボタンとコントロール

送信 / 停止: プロンプトをアシスタントに送信します。生成中はボタンが停止アイコンに切り替わり、リクエストをキャンセルできます。enter / return キーを使用して送信することもできます。
チャットを新規作成: 会話履歴を消去し、新しいセッションを開始します。
ヘルプ: 機能、請求、利用規約に関する情報が表示されたダイアログが開きます。
モデルの選択: 使用する Gemini モデルを選択できるプルダウンメニュー。API キーの階層によっては、一部のモデルが動作しない場合があります。選択した内容は次回のセッションまで保存されます。
ツール切り替え: アシスタントが使用する特定のツールを有効または無効にできるメニュー。選択した内容は次回のセッションまで保存されます。
コピー（コードブロック）: 生成されたコードをクリップボードにコピーします。
挿入（コードブロック）: 生成されたコードをスクリプトエディタに挿入します。エディタが空でない場合は、変更内容を確認するための差分ダイアログが表示されます。
再生成: 最後の回答の下に再試行ボタンが表示され、プロンプトを再実行できます。
トークンカウンタ: 現在の会話セッションで使用されたトークンの数を表示します。これを使用して、API キーの制限に対する使用状況をモニタリングします。

ツールオプション

次のツールを有効にすると、アシスタントの回答の精度を高めることができます。ツールを有効にすると、リクエストにコンテキスト（ドキュメントや検索結果など）が追加され、トークンの使用量が増える可能性があります。

ドキュメント: Earth Engine の一般公開ドキュメントを検索して、正確なコードと説明を提供します。
データセット検索: Earth Engine Data Catalog でデータセットを検索します。
Google 検索: Google 検索の検索結果で回答をグラウンディングし、ウェブから最新の情報を提供します。Google 検索ツールは、ドキュメント検索ツールまたはデータセット検索ツールと同時に使用することはできません。Google 検索を有効にすると、他のツールは UI で自動的に使用できなくなります。

前提条件

この機能は、モデルにリクエストを行うために、ユーザー自身の Gemini API キーを使用します。

Gemini API キーを取得する方法

Gemini API キーは、Google AI Studio の Cloud プロジェクトで作成または表示できます。

Google AI Studio API キーに移動します。
[API キーを作成] をクリックし、キーを作成するオプションを選択します。

Gemini API キーの詳細については、Gemini API キーに関するドキュメントをご覧ください。

コードエディタで API キーを構成する

API キーを取得したら、コードエディタに追加する必要があります。

[質問] パネルで、チャット入力ボックスの鍵アイコンをクリックします。
表示されたダイアログに API キーを貼り付けます。
必要に応じて、チェックボックスをオンにして今後のセッション用にキーを保存し、[OK] をクリックします。

コンテキストの自動取得

関連性の高いサポートを提供するため、質問機能では、すべてのリクエストに次のコンテキストが自動的に含まれます。

エディタに表示されている現在のスクリプトの全文。
インポートされたアセットとジオメトリ。
現在のセッションのチャット履歴。

コンソールエラーのトラブルシューティング

AI アシスタントはコードエディタのコンソールに直接統合されており、ランタイムエラーを迅速に解決できます。

スクリプトでエラーが発生した場合は、[Console] タブで赤いエラーカードを探します。
エラーカードの [トラブルシューティング] ボタンをクリックします。
これにより、[質問] パネルが自動的に開き、エラーメッセージとスクリプトの関連するコンテキストを含む自動生成されたプロンプトメッセージが送信用にキューに登録されます。

プロンプトの例

アシスタントにさまざまなタスクのサポートを依頼するには、チャットボックスに直接入力します。質問できる内容の例をタスク別に示します。

コードの生成とワークフロー

「2023 年の東アフリカの Sentinel-2 画像を読み込み、雲量 10% 未満でフィルタリングし、NDVI の中央値を計算して、白から緑の可視化パレットで地図に追加するスクリプトを作成してください。」
「2024 年の夏の中央ヨーロッパの雲のない Landsat 9 コンポジットを作成し、Cloud Storage バケットにエクスポートして。」

Earth Engine アプリ

「2020 年と 2024 年の画像を並べて比較する Earth Engine アプリの分割パネル地図を作成するコードを記述してください。」
「左側に、年を選択するプルダウンメニューと地図を更新するボタンを含むパネルを追加してください。」
「表示されている土地被覆分類のカスタム凡例を地図に追加します。」

デバッグ

「『ユーザーのメモリ上限を超えました』というエラーが表示されます。どうすれば解決できますか？」
「地図にピクセル値の分散がないレイヤが表示されます。これは想定外です。何が問題なのでしょうか？」
「この計算を実行すると、'Image.select: Band 'NDVI' not found' というエラーが表示されるのはなぜですか？」

解説

「スクリプトの 15 行目で ee.Reducer.mean().combine() が何をしているか説明して。」
「ee.Image.clip() と ee.Image.mask() の違いは何ですか？」

最適化

「この画像コレクションマップオペレーションを最適化して、より効率的に実行できますか？」
「この reduceRegions オペレーションを多くのポリゴンと画像にわたって書き換えて、タイムアウトを回避するにはどうすればよいですか？」

請求と費用

この機能を使用するには、独自の Gemini API キーが必要です。費用は、Gemini API の料金とキーの割り当て階層によって異なります。

無料枠: Gemini API には無料枠（上限あり）があります。
有料枠: 有料枠の API キーを使用すると、Earth Engine プロジェクトの登録に関係なく料金が発生します。

詳細については、Gemini API の料金をご覧ください。

使用状況をモニタリングして費用を管理する

キーの管理、使用量と費用の確認は、AI Studio で直接行うことができます。

AI Studio インターフェースで、API キーのティア、使用量、上限、費用を確認します。
AI Studio の [使用量] タブで、1 か月の利用額上限を設定します。

データとプライバシー

お客様のデータは、Gemini API 利用規約に沿って処理されます。プロンプトと生成されたコンテンツの使用に関するガイドラインを必ずご確認ください。

フィードバック

改善にご協力ください。コードエディタの右上にあるフィードバックボタンをクリックすると、いつでもフィードバックを送信できます。[Send Code Editor feedback] オプションを使用します。このフィードバックは、モデルのパフォーマンスを改善し、機能の優先順位付けを行うために活用されます。