公告：凡是在 2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須驗證非商業用途資格，才能繼續存取 Earth Engine。

本頁面由 Cloud Translation API 翻譯而成。

Method: projects.table.export

啟動批次處理程序，計算資料表並將結果寫入其中一個目的地。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數

參數
`project`	`string` 應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 `projects/{project-id}`。授權需要指定資源 `project` 的下列 IAM 權限： `earthengine.exports.create`

project

string

應視為此要求服務用戶的 Google Cloud Platform 專案專案 ID 或專案編號。格式為 projects/{project-id}。

授權需要指定資源 project 的下列 IAM 權限：

earthengine.exports.create

要求主體

要求主體的資料會採用以下結構：

JSON 表示法

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,
  "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` 提出多個要求，只有其中一個要求才能成功啟動長時間執行作業。`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 表示法

JSON 表示法
{ "fileFormat": enum (`TableFileFormat`), // Union field `destination` can be only one of the following: "driveDestination": { object (`DriveDestination`) }, "cloudStorageDestination": { object (`CloudStorageDestination`) }, "gcsDestination": { object (`GcsDestination`) } // End of list of possible types for union field `destination`. }

{
  "fileFormat": enum (TableFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  },
  "gcsDestination": {
    object (GcsDestination)
  }
  // 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。
`gcsDestination (deprecated)`	`object (GcsDestination)` 這個項目已遭淘汰！如果指定此值，系統會將匯出作業設為匯出至 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。

聯集欄位 destination。結果寫入位置。destination 只能是下列其中一項：

earthEngineDestination

object (EarthEngineDestination)

如果指定此值，系統就會設定匯出至 Earth Engine。

FeatureViewAssetExportOptions

將表格或地圖項目集儲存為 FeatureView 地圖的選項。

JSON 表示法

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)
  },

  // 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。

ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

FeatureView 攝入時間參數。這些參數必須在擷取時指定，且無法即時更新。

聯集欄位 destination。結果寫入位置。destination 只能是下列其中一項：

featureViewDestination

object (FeatureViewDestination)

如果指定，則會將匯出作業設定為 FeatureView。

FeatureViewDestination

Earth Engine 地圖檢視目的地的設定。

JSON 表示法
{ "name": string, "assetVersion": integer }

欄位

欄位
`name`	`string` 必要欄位。FeatureView 資產 ID。伺服器會根據 ID 產生地圖名稱。
`assetVersion`	`integer` 要建立的 FeatureView 資產版本。用於為資產版本建立別名。如果未設定，系統會使用 0。

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。

聯集欄位 destination。寫入資料的位置。destination 只能是下列其中一項：

bigqueryDestination

object (BigQueryDestination)

如果指定，則會設定匯出至 BigQuery。

BigQueryDestination

BigQuery 中的目的地設定。

JSON 表示法
{ "table": string, "overwrite": boolean, "append": boolean }

欄位

欄位
`table`	`string` 必要欄位。BigQuery 目的地資料表參照，格式如下：「projectId.dataset_id.table_id」。如果參照的資源不存在，系統會建立新資料表。如果「append」和「overwrite」參數都為 false，則適用這項做法。如果參照的資源確實存在且具有相容的結構定義，則「overwrite」和「append」參數必須設為 true，否則工作會失敗。如果參照的資源存在，但結構定義與現有結構定義不相容，工作也會失敗。
`overwrite`	`boolean` 指定資料表已存在且具有相容的結構定義時，是否應覆寫資料表資料。 `overwrite` 和 `append` 參數無法同時 `true`。
`append`	`boolean` 指定如果資料表已存在且具有相容的結構定義，是否應附加資料表資料。 `overwrite` 和 `append` 參數無法同時 `true`。

table

string

必要欄位。BigQuery 目的地資料表參照，格式如下：「projectId.dataset_id.table_id」。

如果參照的資源不存在，系統會建立新資料表。如果「append」和「overwrite」參數都為 false，則適用這項做法。

如果參照的資源確實存在且具有相容的結構定義，則「overwrite」和「append」參數必須設為 true，否則工作會失敗。

如果參照的資源存在，但結構定義與現有結構定義不相容，工作也會失敗。

overwrite

boolean

指定資料表已存在且具有相容的結構定義時，是否應覆寫資料表資料。

overwrite 和 append 參數無法同時 true。

append

boolean

指定如果資料表已存在且具有相容的結構定義，是否應附加資料表資料。

overwrite 和 append 參數無法同時 true。

Method: projects.table.export 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

HTTP 要求

路徑參數

要求主體

回應主體

授權範圍

TableFileExportOptions

TableAssetExportOptions

FeatureViewAssetExportOptions

FeatureViewDestination

BigQueryExportOptions

BigQueryDestination

Method: projects.table.export