はじめに
Earth Engine アプリは、Earth Engine で分析を行うための動的で共有可能なユーザー インターフェースです。アプリを使用すると、エキスパートはシンプルな UI 要素を使用して Earth Engine のデータカタログと分析能力を活用できます。これは、エキスパートと非エキスパートの両方が使用できます。
Earth Engine から公開されたアプリには、公開時に生成されたアプリケーション固有の URL からアクセスできます。公開されたアプリを表示または操作するために Earth Engine アカウントは必要ありません。クリエイターが注目のアプリとして選択したアプリは、ユーザー固有のアプリ ギャラリー（USERNAME.users.earthengine.app）。
アプリを作成する
Earth Engine アプリでは、Code Editor で使用されているほとんどの関数を利用できます（いくつかの例外があります）。また、User Interface API はアプリ デベロッパーを念頭に置いて設計されています。User Interface API を初めて使用する場合は、 UI API の概要をご覧ください。
アプリの公開
コードエディタからアプリを公開するには、まずアプリにするスクリプトを読み込み、アプリ管理パネルを開きます。このパネルには、コードエディタのスクリプト セクションの上にある [アプリ] ボタンをクリックしてアクセスできます。
[NEW APP] ボタンをクリックします。
ダイアログで、エディタ アクセス、アプリ名、Google Cloud プロジェクトを選択し、アプリのソースコードの場所を指定します。[制限] タブのオプションを使用して、このアプリへのアクセスを特定の Google グループに制限するか、公開アクセスを維持します。一般公開されるアプリの場合は、[ギャラリー] タブでアプリのカスタム プレビュー画像と説明を指定することもできます。USERNAME.users.earthengine.app で利用可能なアプリの公開ギャラリーにこのアプリを表示する場合は、[アプリ ギャラリーにこのアプリを掲載] をクリックします。必要に応じて、[ロゴ] タブから任意の画像をアップロードして、アプリの左上にカスタムロゴを含めます。
アプリの管理
コードエディタからアプリを管理するには、コードエディタのスクリプト セクションの上にある [アプリ] ボタンをクリックして、アプリ管理パネルを開きます。ここから、アプリの設定を更新したり、アプリを削除したりできます。
プロジェクト所有のアプリで他のユーザーとコラボレーションする
デフォルトでは、ユーザー名で公開したアプリは、そのユーザーのみが編集できます。アプリでのコラボレーションは、プロジェクト所有のアプリで可能です。プロジェクト所有のアプリは、Cloud プロジェクトで所有および公開されるアプリです。Earth Engine Apps パブリッシャー IAM ロールを持つユーザーは、Cloud プロジェクトで公開されているアプリを編集および削除できます。Earth Engine IAM ロールの詳細
プロジェクト所有のアプリを有効にするには、[編集アクセスを選択] の手順で [Cloud プロジェクト] オプションを選択し、使用する Cloud プロジェクトを選択してから、通常どおりアプリ公開フローを完了します。アプリはドメイン PROJECT-ID.projects.earthengine.app に公開され、Cloud プロジェクトに対する Earth Engine Apps パブリッシャー IAM ロールを持つすべてのユーザーが編集できるようになります。
Cloud プロジェクトのアプリを表示するには、[ADD CLOUD PROJECT] ボタンを押して Cloud プロジェクトを選択します。
Cloud プロジェクトを他のユーザーと共有するには、[プロジェクトを共有] ボタンを押します。プロジェクトの Cloud コンソール IAM ページが表示されます。ここで、共同編集者に Earth Engine Apps パブリッシャーの IAM ロールを付与できます。
よくある質問
- アプリ ギャラリーからアプリを削除するにはどうすればよいですか？
- アプリの設定ページの [このアプリを注目のアプリに表示] チェックボックスは、アプリが [注目のアプリ] ページに表示されるかどうかを制御します。アクセスが制限されているアプリは、注目のアプリに掲載できません。
- Earth Engine コードは公開されますか？
- はい。アプリにアクセスできるすべてのユーザーが確認できます。アプリが公開されたときにははっきりと表示されませんが、ウェブブラウザへのネットワーク トラフィックを監視することで、アプリの JavaScript を簡単に確認できます。たとえば Chrome では、デベロッパー ツールの [ ネットワーク パネル] で JavaScript を確認できます。
- 公開済みのアプリで「地図の一部の読み込み中にエラーが発生しました」というエラーが発生する原因として考えられるのはどれですか。
- アプリで使用されているすべての画像アセットまたは表アセットが、一般公開またはアプリと共有されていることを確認します。アセット共有ダイアログで、[誰でも読み取り可能] オプションを選択するか、プルダウン リストからアプリ名を選択します。Google グループに制限されているアプリの場合、その Google グループとアセットを共有しても、アプリでアセットを表示することはできません。代わりに、アプリまたは一般公開でアセットを共有する必要があります。
- 「アプリはまだ準備ができていません」というページが表示されるのはなぜですか？
- アプリの作成後、情報がシステムに反映されるまでに時間がかかることがあります。通常は数分以内に解決されます。エラーが解決しない場合は、お問い合わせください。
- 描画したジオメトリがアプリに表示されるのは何故ですか？
- これにより、アプリに参照ジオメトリを簡単に表示でき、ユーザーがジオメトリを編集できるアプリを作成できます。特定のジオメトリを表示または編集しないようにするには、個々のジオメトリレイヤを非表示またはロックして、アプリを公開する前にユーザーがそれらを表示または編集できないようにします。詳細については、 ジオメトリ ツールのドキュメントをご覧ください。
- アプリの割り当てとは何ですか？
- 誤ったスクリプトやリソースを大量に消費するスクリプトがサービスの可用性に悪影響を及ぼさないように、Earth Engine には同時実行クエリに対するアプリ使用量の割り当てがあります。この割り当ては、Earth Engine の ユーザーごとの割り当てと同様ですが、割り当てが特定のユーザーではなくアプリに関連付けられている点が異なります。
- 作成するアプリごとに割り当てはありますか？
- はい。各アプリに個別の割り当てが関連付けられます。API キーで作成された古いアプリの場合、割り当ては、アプリの API キーを生成する Cloud プロジェクトに関連付けられます。同じ Cloud プロジェクトから複数の API キーを生成すると、それらはすべて同じ使用量の割り当てを共有します。
- Cloud 請求先アカウントが必要なのはなぜですか？アプリの料金は請求されますか？
- Google Cloud Platform は、さまざまなバックグラウンド タスクに使用されます。Earth Engine アプリの作成は無料ですが、Google Cloud Storage は無料ではないため、分析結果を Google Cloud Storage にエクスポートする場合は料金が発生することがあります。
- アプリの使用状況と割り当てを把握するにはどうすればよいですか？
-
割り当てを超えると、Earth Engine から
HTTP 429: Too Many Requestsエラーが返されることがあります。通常、これらのエラーは Earth Engine クライアント ライブラリによって処理されます。このライブラリは、指数バックオフでリクエストをラップし、成功するまでクエリを再試行します。Earth Engine クライアント ライブラリは、リクエストを 5 回再試行します。アプリの人気が高まり、多くのユーザーが割り当て超過エラーを受け取った場合は、ユーザーに警告メッセージが表示され、Earth Engine でアプリへのアクセスが（一時的に）制限されることがあります。
429 エラーを回避するには、アプリケーションのキャッシュを有効にすることをおすすめします。たとえば、キャッシュに保存可能な集計統計情報をその場で計算するのではなく、Earth Engine テーブル アセットとして保存します。