ImageFileExportOptions

將圖片匯出為 Earth Engine 外部檔案的選項。

JSON 表示法
{
  "fileFormat": enum (ImageFileFormat),

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "geoTiffOptions": {
    object (GeoTiffImageExportOptions)
  },
  "tfRecordOptions": {
    object (TfRecordImageExportOptions)
  }
  // End of mutually exclusive fields.
}
欄位
fileFormat

enum (ImageFileFormat)

匯出圖片的檔案格式。

要將結果寫入何處。以下列出互斥的欄位。回應中最多會設定一個欄位:
driveDestination

object (DriveDestination)

如有指定,系統會設定匯出至 Google 雲端硬碟。

cloudStorageDestination

object (CloudStorageDestination)

如果指定,則設定匯出至 Google Cloud Storage。

互斥欄位的結尾。
檔案格式專屬選項。以下列出互斥的欄位。回應中最多會設定一個欄位:
geoTiffOptions

object (GeoTiffImageExportOptions)

GEO_TIFF 匯出時的檔案格式專屬選項。

tfRecordOptions

object (TfRecordImageExportOptions)

TF_RECORD_IMAGE 匯出時的檔案格式專屬選項。

互斥欄位的結尾。

GeoTiffImageExportOptions

將圖片編碼為 GeoTIFF 檔案的選項。

JSON 表示法
{
  "cloudOptimized": boolean,
  "tileDimensions": {
    object (GridDimensions)
  },
  "skipEmptyFiles": boolean,
  "tileSize": integer,
  "noData": {
    object (Number)
  },
  "metadataKeys": [
    string
  ]
}
欄位
cloudOptimized

boolean

如果為 true,則會產生「雲端最佳化」GeoTIFF 檔案,以便在雲端環境中更有效率地存取 (請參閱 www.cogeo.org)。

tileDimensions

object (GridDimensions)

選用,以像素為單位的明確尺寸,如果圖片過大而無法放入單一檔案,則可將圖片分割成多個部分。這個值必須設為圖塊大小的倍數,預設為 256。

skipEmptyFiles

boolean

如果為 true,則略過寫入空白 (即完全遮蓋) 圖片檔。

tileSize

integer

(選用步驟) 選用參數,可設定輸出圖塊大小。這個參數是中間輸出圖塊的邊長 (以像素為單位)。預設圖塊大小為 256,對應的圖塊為 256x256。

noData

object (Number)

(選用步驟) 選填的無資料值。目前僅支援 noData.float_value

metadataKeys[]

string

(選用步驟) 用於設定 GeoTIFF 屬性的中繼資料鍵。系統會從圖片讀取每個鍵的屬性值。這些值通常必須是字串。對於 TIFFTAG_DATETIME 鍵,值也可以是 ee.Date 執行個體或數字 (自 Epoch 以來的毫秒數),這些值會自動轉換為 "YYYY:MM:DD HH:MM:SS" 字串格式。如果指定 TIFFTAG_DATETIME,但未在圖片上設定,則預設值為 system:time_start (如有)。

數字

數字。

JSON 表示法
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "floatValue": number,
  "integerValue": string
  // End of mutually exclusive fields.
}
欄位
值。以下列出互斥的欄位。回應中最多會設定一個欄位:
floatValue

number

雙精度浮點值。

integerValue

string (int64 format)

64 位元整數值。

互斥欄位的結尾。

TfRecordImageExportOptions

將圖片編碼為 TFRecord 檔案的選項。

JSON 表示法
{
  "tileDimensions": {
    object (GridDimensions)
  },
  "marginDimensions": {
    object (GridDimensions)
  },
  "compress": boolean,
  "maxSizeBytes": string,
  "defaultValue": number,
  "tensorDepths": {
    string: integer,
    ...
  },
  "sequenceData": boolean,
  "collapseBands": boolean,
  "maxMaskedRatio": number
}
欄位
tileDimensions

object (GridDimensions)

在匯出區域中以平鋪方式排列的尺寸,可精確涵蓋每個像素一次 (除非修補程式尺寸無法平均分割外框,在這種情況下,系統會沿著最大 x/y 邊緣捨棄邊界圖塊)。尺寸必須大於 0。

marginDimensions

object (GridDimensions)

如果指定,圖塊會以正負邊界尺寸緩衝,導致相鄰修補程式之間重疊。

compress

boolean

如果設為 true,系統會使用 gzip 壓縮 .tfrecord 檔案,並附加「.gz」字尾。

maxSizeBytes

string (Int64Value format)

匯出 .tfrecord 的大小上限 (以位元組為單位,壓縮前)。檔案越小,分片越多 (因此輸出檔案也越多)。預設值為 1 GiB。

defaultValue

number

部分或完全遮蔽的像素各個頻帶中設定的值,以及從陣列頻帶建立的輸出 3D 特徵中,每個值設定的值,其中來源像素的陣列長度小於特徵值的深度。如果是整數型頻帶,系統會捨棄小數部分,並限制在頻帶類型的範圍內。預設為 0。

tensorDepths

map (key: string, value: integer)

從輸入陣列頻帶名稱到所建立 3D 張量的深度的對應。陣列會遭到截斷,或以預設值填補,以符合指定的形狀。每個陣列頻帶都必須有對應的項目。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

sequenceData

boolean

如果是 true,系統會將每個像素輸出為 SequenceExample,將純量頻帶對應至內容,並將陣列頻帶對應至範例的序列。SequenceExample 會依每個修補程式的像素列優先順序輸出,然後依檔案序列中的區域修補程式列優先順序輸出。

collapseBands

boolean

如果為 true,所有波段都會合併為單一 3D 張量,並採用圖片中第一個波段的名稱。所有頻帶都會依序升級為位元組、int64,然後是浮點數,具體取決於所有頻帶中該序列最遠的類型。只要指定 tensorDepths,即可使用陣列頻帶。

maxMaskedRatio

number

圖塊中遮蓋像素的比例上限。如果修補程式超過此配額,系統會捨棄而非寫入檔案。如果這個欄位設為 1 以外的值,系統就不會產生 JSON Sidecar。預設值為 1。