Method: projects.table.export

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

HTTP リクエスト

POST https://earthengine.googleapis.com/v1beta/{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,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
フィールド
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 です。
共用体フィールド export_options。結果の保存場所と保存方法を記述するオプション。export_options は次のいずれかになります。
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),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
フィールド
fileFormat

enum (TableFileFormat)

テーブルをエクスポートするファイル形式。
共用体フィールド destination。結果を書き込む場所。destination は次のいずれかになります。
driveDestination

object (DriveDestination)

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

object (CloudStorageDestination)

指定すると、Google Cloud Storage へのエクスポートを構成します。

TableAssetExportOptions

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

JSON 表現 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
フィールド
共用体フィールド destination。結果を書き込む場所。destination は次のいずれかになります。
earthEngineDestination

object (EarthEngineDestination)

指定すると、Earth Engine へのエクスポートを構成します。

FeatureViewAssetExportOptions

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

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

  // Union field destination can be only one of the following:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of list of possible types for union field destination.
}
フィールド
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

FeatureView 取り込み時間のパラメータ。これらのパラメータは取り込み時に指定する必要があり、その場で更新することはできません。
共用体フィールド destination。結果を書き込む場所。destination は次のいずれかになります。
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 表現 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
フィールド
共用体フィールド destination。データを書き込む場所。destination は次のいずれかになります。
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 にすることはできません。