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 实例或数字(自纪元以来的毫秒数),这些值会自动转换为 "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 文件(压缩前)的大小上限(以字节为单位)。文件越小,分片越多(因此,输出文件也越多)。默认为 1GiB。

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 辅助信息文件。默认为 1。