Method: projects.table.export

テーブルを計算し、結果を複数の宛先のいずれかに書き込むバッチ処理を開始します。

HTTP リクエスト

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:export

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
project

string

このリクエストのサービス ユーザーとして扱う Google Cloud Platform プロジェクトのプロジェクト ID またはプロジェクト番号。形式は projects/{project-id} です。

認可には、指定されたリソース project に対する次の IAM の権限が必要です。

  • earthengine.exports.create

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
フィールド
expression

object (Expression)

計算してエクスポートするテーブルに評価される式。
description

string

人が読める形式のタスク名。
selectors[]

string

結果に含める列の明示的なリスト。
requestId

string

重複したリクエストを検出するために使用される一意の文字列。同じユーザーが同じ空でない requestId を使用して複数のリクエストを行う場合、それらのリクエストのうち 1 つだけが長時間実行オペレーションを正常に開始できます。requestId には、a ～ z、A ～ Z、0 ～ 9、または「-」の文字を含めることができます。requestId の最大長は 60 文字です。
maxErrorMeters

number

座標系間でジオメトリを変換する際に許容される最大誤差（メートル単位）。空の場合、デフォルトで最大誤差は 1 メートルです。
maxVertices

integer

ジオメトリあたりの未カット頂点の最大数。頂点数がこの数を超えるジオメトリは、このサイズより小さいピースにカットされます。
workloadTag

string

この計算を追跡するためにユーザーが指定したラベル。
priority

integer

省略可。プロジェクト内のエクスポート タスクの優先度。優先度の高いタスクは、より早くスケジュールされます。0 ～ 9999 の整数を指定してください。設定しない場合、デフォルトは 100 です。
結果の保存場所と保存方法を指定するオプション。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
fileExportOptions

object (TableFileExportOptions)

指定すると、ファイルとしてエクスポートするように構成されます。
assetExportOptions

object (TableAssetExportOptions)

指定すると、エクスポートを Earth Engine アセットとして構成します。
featureViewExportOptions

object (FeatureViewAssetExportOptions)

指定すると、エクスポートを FeatureView マップとして構成します。
bigqueryExportOptions

object (BigQueryExportOptions)

指定されている場合、表形式データの BigQuery へのエクスポートを構成します。
相互に排他的なフィールドの終了。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

詳細については、OAuth 2.0 Overview をご覧ください。

TableFileExportOptions

Earth Engine の外部でテーブルをファイルとしてエクスポートするためのオプション。

JSON 表現 
{
  "fileFormat": enum (TableFileFormat),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
フィールド
fileFormat

enum (TableFileFormat)

テーブルをエクスポートするファイル形式。
結果を書き込む場所。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
driveDestination

object (DriveDestination)

指定すると、Google ドライブへのエクスポートが構成されます。
cloudStorageDestination

object (CloudStorageDestination)

指定すると、Google Cloud Storage へのエクスポートが構成されます。
相互に排他的なフィールドの終了。

TableAssetExportOptions

テーブルを Earth Engine アセットとして保存するためのオプション。

JSON 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
フィールド
結果を書き込む場所。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
earthEngineDestination

object (EarthEngineDestination)

指定すると、Earth Engine へのエクスポートが構成されます。
相互に排他的なフィールドの終了。

FeatureViewAssetExportOptions

テーブルまたは FeatureCollection を FeatureView マップとして保存するためのオプション。

JSON 表現 
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of mutually exclusive fields.
}
フィールド
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

FeatureView の取り込み時間パラメータ。これらのパラメータは取り込み時に指定する必要があり、オンザフライで更新することはできません。
結果を書き込む場所。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
featureViewDestination

object (FeatureViewDestination)

指定されている場合、FeatureView へのエクスポートを構成します。
相互に排他的なフィールドの終了。

FeatureViewDestination

Earth Engine FeatureView の宛先の構成。

JSON 表現 
{
  "name": string,
  "assetVersion": integer
}
フィールド
name

string

必須。FeatureView アセット ID。サーバーは ID からマップ名を生成します。
assetVersion

integer

作成する FeatureView アセット バージョン。アセットのバージョンにエイリアスを設定するために使用されます。設定しない場合、0 が使用されます。

BigQueryExportOptions

表形式のデータを BigQuery にエクスポートするためのオプション。

JSON 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
フィールド
データの書き込み先。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
bigqueryDestination

object (BigQueryDestination)

指定されている場合、BigQuery へのエクスポートを構成します。
相互に排他的なフィールドの終了。

BigQueryDestination

BigQuery の宛先の構成。

JSON 表現 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
フィールド
table

string

必須。「projectId.dataset_id.table_id」の形式で表される、BigQuery の宛先テーブル参照。

参照されたリソースが存在しない場合は、新しいテーブルが作成されます。これは、「append」パラメータと「overwrite」パラメータの両方が false の場合にも適用されます。

参照されたリソースが存在し、互換性のあるスキーマがある場合、「overwrite」または「append」パラメータのいずれかが true である必要があります。そうでない場合、タスクは失敗します。

参照されたリソースが存在し、スキーマが既存のスキーマと互換性がない場合、タスクも失敗します。
overwrite

boolean

テーブルがすでに存在し、互換性のあるスキーマがある場合に、テーブルデータを上書きするかどうかを指定します。

overwrite パラメータと append パラメータを同時に true にすることはできません。
append

boolean

テーブルがすでに存在し、互換性のあるスキーマがある場合に、テーブルデータを追加するかどうかを指定します。

overwrite パラメータと append パラメータを同時に true にすることはできません。