アセット マネージャーまたはコマンドライン インターフェース(CLI)を使用して、GeoTIFF 形式または TFRecord 形式の画像やその他の地理参照ラスター データセットをアップロードできます。(コードエディタを使用してベクトルをインポートする方法については、ベクトルデータのインポートをご覧ください)。
画像アセットをアップロードする
GeoTIFF
コードエディタでは、最大 10 GB の GeoTIFF 画像ファイルを Earth Engine ユーザー フォルダにアップロードできます。(サイズの大きいファイルの場合は、コマンドライン アップロード オプションを使用します)。
コードエディタを使用して GeoTIFF をアップロードするには、左上の [Assets] タブを選択し、
ボタンをクリックして、[Image upload] を選択します。Earth Engine に、図 1 のようなアップロード ダイアログが表示されます。[SELECT] ボタンをクリックし、ローカル ファイル システム上の GeoTIFF に移動します。
ユーザー フォルダ内の画像に適切なアセット ID(まだ存在しないもの)を付けます。既存のフォルダまたはコレクションに画像をアップロードする場合は、アセット ID の前にフォルダまたはコレクション ID を付けます(例: projects/myproject/folder-or-collection-id/new-asset)。
[アップロード] をクリックしてアップロードを開始します。
アップロードを開始すると、コードエディタの右側にある [Tasks] タブに [Asset ingestion] タスクが表示されます。タスク マネージャーでタスクにカーソルを合わせると、? が表示されます。アイコンが表示されます。このアイコンを使用してアップロードのステータスを確認できます。アップロードをキャンセルするには、タスクの横にある回転アイコン
をクリックします。取り込みが完了すると、アセットが アイコンとともにユーザー フォルダに表示されます。
GeoTIFF 圧縮
GeoTIFF ファイルは、DEFLATE、JPEG、JPEG-XL/JXL、LERC、LERC_DEFLATE、LERC_ZSTD、LZMA、LZW、WEBP、ZSTD で圧縮できます。Earth Engine が取り込むのではなく、その場で読み取る Cloud Optimized GeoTIFF(COG)は、より狭いセットを受け入れます。COG 圧縮をご覧ください。
大容量ファイルをアップロードする際のおすすめの方法は次のとおりです。
- 最適な選択肢: ZSTD は、速度と圧縮のバランスに優れています。
- 避けるべきこと: LZMA は圧縮率は高いものの、非常に時間がかかることがあります。
- 非圧縮ファイル: ファイルサイズが大きくなり、アップロード時間が長くなります。
- 非可逆圧縮(JPEG など): ピクセル値が変更される可能性があります。データへの潜在的な影響を理解していない限り、非可逆圧縮ではなく可逆圧縮(DEFLATE、LZMA、LZW、ZSTD など)を使用します。
TFRecord
TFRecord ファイルから画像をアップロードするには、推論を実行した画像をエクスポートしたときに生成された、関連するミキサー ファイルが必要です。ミキサー ファイルの詳細については、エクスポート ページをご覧ください。具体的には、エクスポートされた画像に対して行われた予測を(画像として)インポートするには、
- 画像を 1 つ以上の TFRecord ファイルにエクスポートします。
- 画像(
model.predict())に対して推論を実行します。 model.predict()の出力を TFRecord ファイルに書き込みます。予測は、推論を実行した画像エクスポートと同じ順序にする必要があります。順序は、エクスポートによって生成されたファイル名の並べ替えによって適用できます。詳しくは、大きなファイルのエクスポートに関するセクションをご覧ください。- TFRecord ファイルと関連するミキサーを Earth Engine にアップロードします。
プロパティの編集
1 つ以上のメタデータ プロパティを指定して、アセットのメタデータを編集します。[Properties] メニューで [Add property] をクリックして、プロパティの名前と値を定義します(図 2)。値は文字列または数値です。文字列は引用符なしで入力します。数値を文字列として書式設定するには、数値の前に一重引用符(')を入力します。
デフォルトでは、system:time_start プロパティが値なしで追加されます。このプロパティは、ImageCollection 日付フィルタを適用するときに Earth Engine によって使用されます。図 2 に示す形式の日付か、1970 年 1 月 1 日からのミリ秒数を入力します。(Earth Engine のタイムスタンプの詳細については、用語集をご覧ください)。アセット マネージャーは、system:time_start または system:time_end という名前のプロパティの値として入力された数値をミリ秒として解釈し、日付としてフォーマットします。
アイコンをクリックして、プロパティを削除します。
詳細オプション
[詳細] メニューで、データのピラミッド ポリシーとマスキング モードを選択します。
ピラミッド ポリシーは、Earth Engine が画像の低解像度バージョンを生成する方法を指定します。Earth Engine が複数の解像度を処理する方法については、スケールに関するドキュメントをご覧ください。ピラミッド ポリシーとして「Mean」、「Min」、「Max」のいずれかを選択すると、高解像度ピクセルの 2x2 グループごとに平均、最小、最大を計算して、画像ピラミッドの低解像度レベルを計算します。これは、連続値の画像に適したオプションです。カテゴリデータ(土地被覆など)または QA データの場合は、「サンプル」(左上のピクセル)または「モード」(最も頻繁に発生する値、またはモードがない場合はサンプル)のピラミッド ポリシーを選択します。
マスキング モードは、アップロードされた画像がどのようにマスクされるかを示します(マスクされる場合)。データなしの値を指定するには、[データなしの値] を選択して値を入力します。この値を持つピクセルは、アップロードされた画像でマスクされます。この値は、画像の各バンドに個別に適用されます。画像の最後のバンドを他の画像バンドのマスクとして使用するには、[最後のバンドをアルファバンドとして使用] を選択します。アルファバンドは、0 がマスクされた(完全に透明な)データで、255 が完全に不透明な、符号なし 8 ビットバンドにする必要があります。
タイル形式のアップロード
1 つの画像を複数のタイルとしてアップロードし、各タイルを異なるソースファイルに保存するには、[別のファイルを追加] をクリックして、アップロードするファイルを追加します。Earth Engine はタイルを結合して、ユーザー フォルダに 1 つの画像を作成します。
画像アセットにアップロードできるファイルの種類には、いくつかの制約があります。具体的には、次のとおりです。
- 画像は、バンド数、ビット深度、投影、解像度、フィル値が同じである必要があります。
- 1 つのファイルから次のファイルへのオフセットは、ピクセルサイズの整数倍にする必要があります。
- タイル間のギャップは、最終的な画像でマスクされたピクセルで埋められます。そのため、タイルは、まばらに配置されるのではなく、隣接していることが理想的です。画像領域の 99% 以上を占めるギャップのある画像は取り込まれません。