アセット マネージャーまたはコマンドライン インターフェース(CLI)を使用して、画像やその他の地理参照ラスター データセットを GeoTIFF 形式または TFRecord 形式でアップロードできます。(コードエディタを使用してベクトルをインポートする方法については、ベクトルデータのインポートをご覧ください)。
画像アセットのアップロード
GeoTIFF
Code Editor では、最大 10 GB の GeoTIFF 画像ファイルを Earth Engine ユーザー フォルダにアップロードできます。(サイズの大きいファイルの場合は、コマンドライン アップロード オプションを使用します)。
Code Editor を使用して GeoTIFF をアップロードするには、左上の [アセット] タブを選択し、 ボタンをクリックして、[画像のアップロード] を選択します。Earth Engine にアップロード ダイアログが表示されます。このダイアログは図 1 のようになります。[SELECT] ボタンをクリックし、ローカル ファイル システムの GeoTIFF に移動します。
ユーザー フォルダに、画像に適切なアセット ID(まだ存在しない ID)を割り当てます。既存のフォルダまたはコレクションに画像をアップロードする場合は、アセット ID の前にフォルダまたはコレクション ID(projects/myproject/folder-or-collection-id/new-asset
など)を付けます。
[アップロード] をクリックしてアップロードを開始します。

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