テーブルデータをインポートする

テーブル アセットをアップロードする

アセット マネージャーまたはコマンドライン インターフェース(CLI)を使用して、Shapefile 形式または CSV 形式でデータセットをアップロードできます。(コードエディタまたは CLI を使用したラスターのインポートの詳細については、ラスターデータのインポートをご覧ください)。アップロードしたアセットは、最初は非公開ですが、アセットの共有セクションの説明に沿って共有できます。

シェープファイルをアップロードする

コードエディタからシェープファイルをアップロードするには、 ボタンをクリックし、[Table Upload] セクションで [Shape files] を選択します。図 1 のようなアップロード ダイアログが表示されます。[選択] ボタンをクリックし、ローカル ファイル システム上のシェープファイルまたはシェープファイルを含む ZIP アーカイブに移動します。.shp ファイルを選択する際は、関連する .dbf、.shx、.prj ファイルも選択してください。.prj ファイルが指定されていない場合、Earth Engine はデフォルトで WGS84(経度、緯度)座標を使用します。ZIP アーカイブをアップロードする場合は、1 つのシェイプファイル(.shp、.dbf、.shx、.prj などのセット)のみが含まれ、ファイル名が重複していないことを確認してください。ファイル名に余分なピリオドやドットが含まれていないことを確認してください。(ファイル名には、拡張子の前にピリオドが 1 つ含まれます)。

ユーザー フォルダ内のテーブルに、適切なアセット ID(まだ存在しないもの)を付けます。[アップロード] をクリックしてアップロードを開始します。

アセット
図 1. アセット マネージャーのシェープファイル アップロード ダイアログ。.shp、.dbf、.shx ファイルは必須です。その他のサイドカー ファイルは省略可能です。.prj ファイルが指定されていない場合は、WGS84 と見なされます。

CSV ファイルをアップロードする

コードエディタから CSV をアップロードするには、[Assets] タブを有効にして ボタンをクリックし、[Table Upload] セクションの [CSV file] を選択します。図 2 のようなアップロード ダイアログが表示されます。[選択] ボタンをクリックし、ローカル ファイル システムの .csv ファイルに移動します。テーブルに一意の関連するアセット ID 名を付けます。 [OK] をクリックしてアップロードを開始します。

アセット
図 2. [Asset Manager] の CSV ファイル アップロード ダイアログ。

CSV ファイルには、各特徴の行と、特徴セットのプロパティまたは変数と同じ数の列が含まれている必要があります。特徴が地理空間の場合、ジオメトリ文字列(GeoJSON、WKT)または x と y の位置プロパティで定義された位置情報が必要です。CSV ファイルが GDAL/OGR などの GIS または地理空間データツールからエクスポートされたものである場合は、適切な形式と名前のジオメトリ列がすでに存在しているはずです。または、ポイントの位置を表す X 座標と Y 座標の 2 つの列をスプレッドシート アプリケーションで定義し、他の変数とともに CSV 形式でエクスポートすることもできます。

詳細オプション

アップロード ダイアログの [詳細オプション] セクションで、デフォルト設定を確認して変更します。頂点数が多いジオメトリを分割すると、Earth Engine のパフォーマンスを向上させることができます。Earth Engine では、頂点が 100 万を超える対象物は許可されません。テーブルのアップロード中に、Earth Engine は 100 万を超える頂点を持つジオメトリを自動的に分割します。値を小さくすると、ベクター レンダリングのパフォーマンスが向上します。

Earth Engine は、プライマリ ジオメトリ列の検出を試みます。特に指定がない限り、データ プロジェクションは WGS84 と見なされます。ジオメトリの測地線状態は、指定された投影のデフォルトのエッジ解釈によって決まります(たとえば、WGS84 は測地線ジオメトリを使用します)。ただし、これは [Advanced settings] メニューでオーバーライドできます。データのジオメトリが x 列と y 列で定義されたポイントである場合は、それぞれの列に「longitude」と「latitude」という名前を付けるか、[詳細設定] で x 列と y 列の名前を指定してください。

アップロードの進捗状況を追跡する

テーブルのアップロードを開始すると、コードエディタの右側にある [Tasks] タブのタスク マネージャーに「アセットの取り込み」タスクが追加されます。アップロードのステータスを確認するには、?アイコンをクリックします。アップロードをキャンセルするには、タスクの横にある回転アイコン をクリックします。取り込みが完了すると、タスクセルが青色に変わり、[アセット] タブのユーザー フォルダに アイコン付きでアセットが表示されます。

テーブルのアップロードの上限

テーブルをアップロードする場合、テーブル内の対象物の最大数は 1 億個です。1 つの対象物に含まれるプロパティの最大数は 1,024 です。これらの上限により、生成されたアセットを効率的にクエリできます。また、各対象物には、上記の「詳細オプション」セクションで説明したように、頂点の最大数があります。

テーブル アセットをスクリプトに読み込む

テーブル アセットからスクリプトに FeatureCollection を作成するには、アセットの管理ページの説明に沿ってインポートします。