REST Resource: projects.assets

资源：EarthEngineAsset

有关 Earth Engine 资产的信息。

JSON 表示法 
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string,
  "featureCount": string,
  "quota": {
    object (FolderQuota)
  },
  "tilesets": [
    {
      object (Tileset)
    }
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "gcsLocation": {
    object (GcsLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of mutually exclusive fields.
}
字段
type

enum (Type)

资源的类型。
name

string

资产的名称。name 的格式为“projects/*/assets/**”（例如“projects/earthengine-legacy/assets/users//”）。
id

string

相应资产的 ID。相当于 name，但不含“projects/*/assets/”前缀（例如“users//”）。请注意，此设置仅用于显示目的。不应将其用作其他操作的输入。请改用 name。
updateTime

string (Timestamp format)

相应资产的上次修改时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
title
(deprecated)

string

资源的标题。
description
(deprecated)

string

相应资产的说明。
properties

object (Struct format)

与相应素材资源相关联的键/值属性。
startTime

string (Timestamp format)

与相应资产相关联的时间戳（如果有），例如拍摄卫星图像的时间。对于与时间间隔对应的资产（例如一个月或一年的平均值），此时间戳对应于该时间间隔的开始时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

对于与时间区间对应的资产（例如一个月或一年的平均值），此时间戳对应于该区间的结束时间（不含）。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
geometry

object (Struct format)

与相应资产关联的空间覆盖区（如有），以 GeoJSON 几何对象的形式表示（请参阅 RFC 7946）。
bands[]

object (ImageBand)

有关图片素材资源数据波段的信息。对于非图片素材资源，则会省略。
sizeBytes

string (int64 format)

叶级素材资源（例如图片）的大小（以字节为单位）。
featureCount

string (int64 format)

相应素材资源中的功能数量（如适用）。
quota

object (FolderQuota)

与文件夹资产关联的配额信息（如果有）。针对顶级用户自有文件夹资产（例如“users/*”或“projects/*”）返回。
tilesets[]

object (Tileset)

支持相应图片的图块集。仅适用于像素是从非 Earth Engine 拥有的存储空间检索的外部映像。
有关栅格图块的存储位置和存储方式的信息。以下是互斥字段的列表。在响应中，最多只能设置一个字段：
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

已弃用。请改用 ImportExternalImage。如需了解详情，请访问 https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff。
gcsLocation
(deprecated)

object (GcsLocation)

已弃用。请改用 ImportExternalImage。如需了解详情，请访问 https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff。
featureViewAssetLocation

object (FeatureViewLocation)

相应 FeatureView 在 EE 中的位置。
互斥字段的结束位置。

CloudStorageLocation

Cloud Storage 上资产的位置。

JSON 表示法 
{
  "uris": [
    string
  ]
}
字段
uris[]

string

数据的 URI。仅支持 Google Cloud Storage URI。每个 URI 都必须采用以下格式指定：“gs://bucket-id/object-id”。目前仅支持一个 URI。如果指定了多个 URI，则会返回 INALID_ARGUMENT 错误。

GcsLocation

Cloud Storage 上资产的位置。

JSON 表示法 
{
  "uris": [
    string
  ]
}
字段
uris[]

string

数据的 URI。仅支持 Google Cloud Storage URI。每个 URI 都必须采用以下格式指定：“gs://bucket-id/object-id”。目前仅支持一个 URI。如果指定了多个 URI，则会返回 INALID_ARGUMENT 错误。

FeatureViewLocation

FeatureView EE 资源。

JSON 表示法 
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
字段
assetOptions

object (FeatureViewOptions)

FeatureView 资产的提取时选项。

FeatureViewOptions

FeatureView 资产的提取时选项。

JSON 表示法 
{
  "featureViewAttributes": [
    {
      object (FeatureViewAttribute)
    }
  ],
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  }
}
字段
featureViewAttributes[]

object (FeatureViewAttribute)

FeatureView 资产中的属性，包含该资产的架构。这些是相应素材资源中的功能可以具有的属性。每个属性都有一个名称和一个类型。
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

FeatureView 提取时间参数。

FeatureViewAttribute

FeatureView 属性及其类型。

JSON 表示法 
{
  "name": string,
  "type": enum (Type)
}
字段
name

string

属性的名称。
type

enum (Type)

属性的类型。

类型

这些类型与 geo/enterprise/layers/public/data_source_schema.proto 中的类型相同。

枚举
TYPE_UNSPECIFIED 未指定类型。
INTEGER 64 位整数值。
BOOLEAN True/False 布尔值。
DOUBLE 双精度浮点数。
STRING 长度不受限制的字符串。
DATE_TIME 日期/时间，以自纪元起计的有符号 64 位整数（以微秒为单位）表示，因此支持从公元前 290,308 年到公元 294,247 年的时间段。

FeatureViewIngestionTimeParameters

FeatureView 提取时间参数。这些参数必须在提取时指定，并且无法针对 FeatureView 实时更新。

JSON 表示法 
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
字段
thinningOptions

object (ThinningOptions)

允许与图块相交的要素边界框数量上限。此数字必须是非负数。
rankingOptions

object (RankingOptions)

用于为要素分配 z 顺序等级和精简等级的选项。

ThinningOptions

用于控制每个图块中显示的功能密度的精简选项。

JSON 表示法 
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
字段
maxFeaturesPerTile

integer

允许与图块相交的要素边界框数量上限。此数字必须是非负数。
thinningStrategy

enum (ThinningStrategy)

应使用的特征精简策略。

ThinningStrategy

特征的精简策略。

枚举
UNKNOWN_THINNING_STRATEGY 未知精简策略。
GLOBALLY_CONSISTENT 在特定 LOD 进行精简时，全局一致的精简意味着，如果某个特征因精简而被移除，那么所有其他精简等级等于或更差的特征也会被移除。
HIGHER_DENSITY

在精简时，请尽量接近每个图块的 maxFeaturesPerTile 上限。我们会优先选择排名较高的特征，但有时也会舍弃排名较高的特征，以便实现更高的特征密度。

我们保证该策略是确定性的，并且精简后的特征集将是全局一致性精简所生成的特征集的超集。

RankingOptions

用于确定 Z 顺序和细化的排名选项。

JSON 表示法 
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
字段
zOrderRankingRule

object (RankingRule)

用于为功能分配 z-order 排名的排名规则。
thinningRankingRule

object (RankingRule)

用于为特征分配精简等级的排名规则。

RankingRule

用于控制如何对功能进行排名以实现精简和 Z 轴顺序的排名规则。

JSON 表示法 
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
字段
rankByOneThingRule[]

object (RankByOneThingRule)

一个有序列表，包含零个或多个按某项（例如属性）排序的规则，这些规则用作主要、次要等排名键，用于在每个 RankedFeature 中设置 thinning_rank。

RankByOneThingRule

用于控制精简和 Z 顺序的单个排名规则。

JSON 表示法 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of mutually exclusive fields.
  "direction": enum (Direction)
}
字段
要使用的排名规则类型。以下是互斥字段的列表。在响应中，最多只能设置一个字段：
rankByAttributeRule

object (RankByAttributeRule)

按功能属性值进行排名。
rankByMinVisibleLodRule
(deprecated)

object (RankByMinVisibleLodRule)

按功能几何图形首次可见时的最小 LOD 进行排名。具有任何点数的功能始终在所有 LOD 中可见。已弃用：请改用 rankByMinZoomLevelRule。
rankByGeometryTypeRule

object (RankByGeometryTypeRule)

按几何图形类型排名。类型的优先级（从高到低）：多边形、多段线、点、无。如果某项功能有多种类型，则优先级最高的类型优先。
rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

按功能几何图形首次可见的最小缩放级别进行排名。具有任何点数的功能始终在所有 LOD 中可见。
互斥字段的结束位置。
direction

enum (Direction)

按此一项进行排名时，应采用升序（值越小越重要）还是降序（值越大越重要）。换句话说，ASCENDING 表示直接使用下面 RankByAttributeRule（或其他）子消息文档中描述的排序，而 DESCENDING 表示反转该排序。

RankByAttributeRule

按功能属性值进行排名。

JSON 表示法 
{
  "attributeName": string
}
字段
attributeName

string

按具有指定名称的属性的值进行排名。这主要是给定类型值的自然排序，但有一些细微差别和说明：- 对于整数属性，较低的值排在较高的值之前- 对于双精度属性，较低的值排在较高的值之前，NaN 被视为低于所有其他值（包括负无穷大）- 对于布尔属性，false 被视为排在 true 之前- 对于 date_time 属性，较早的值排在较晚的值之前- 字符串属性按字典顺序排序- 值未设置的属性被视为具有给定类型的默认值（整数为 0，布尔值为 false 等）。

RankByMinVisibleLodRule

此类型没有字段。

按功能几何图形首次可见时的最小 LOD 进行排名。具有任何点数的功能始终在所有 LOD 中可见。

RankByGeometryTypeRule

此类型没有字段。

按几何图形类型排名。类型的优先级（从高到低）：多边形、多段线、点、无。如果某项功能有多种类型，则优先级最高的类型优先。

RankByMinZoomLevelRule

此类型没有字段。

按功能几何图形首次可见的最小缩放级别进行排名。具有任何点数的功能始终在所有 LOD 中可见。

方向

是否按从低到高 (ASCENDING) 或从高到低 (DESCENDING) 的顺序对列表进行排序。

枚举
DIRECTION_UNSPECIFIED 未指定排名方向。
ASCENDING 升序。
DESCENDING 降序。

类型

素材资源的类型。

枚举
TYPE_UNSPECIFIED 未指定。
IMAGE 图片。
IMAGE_COLLECTION 图片集。
TABLE 表格。
FOLDER 文件夹。
CLASSIFIER 分类器。
FEATURE_VIEW FeatureView 资源。

ImageBand

有关图片素材资源的单个数据波段的信息。

JSON 表示法 
{
  "id": string,
  "dataType": {
    object (PixelDataType)
  },
  "grid": {
    object (PixelGrid)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "missingData": {
    object (MissingData)
  }
}
字段
id

string

频段的 ID。
dataType

object (PixelDataType)

频段的数值类型。
grid

object (PixelGrid)

频段的像素网格。
pyramidingPolicy

enum (PyramidingPolicy)

相应频段的累积政策。
missingData

object (MissingData)

表示缺失数据的值。

PixelDataType

指定图像波段中像素的数值类型。

JSON 表示法 
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
字段
precision

enum (Precision)

相应类型的数值精度。
range

object (DoubleRange)

数值类型的范围（如果有）。对于浮点类型，通常不存在。
dimensionsCount

integer

数组值数据类型中的维度数量，或零（表示普通标量类型）。

精确率

指定数值数据类型的精度。

枚举
PRECISION_UNSPECIFIED 未指定。
INT 数据类型具有整数精度。请注意，这可能表示不同大小的整数。
FLOAT 数据类型具有 32 位浮点精度。
DOUBLE 数据类型具有 64 位浮点（双精度）精度。

MissingData

表示无数据的值的列表。

JSON 表示法 
{
  "values": [
    number
  ]
}
字段
values[]

number

表示无数据的值。

FolderQuota

描述顶级文件夹的当前使用情况和限制。

JSON 表示法 
{
  "sizeBytes": string,
  "maxSizeBytes": string,
  "assetCount": string,
  "maxAssets": string,
  "maxAssetCount": string
}
字段
sizeBytes

string (int64 format)

相应文件夹的大小（以字节为单位）。
maxSizeBytes

string (int64 format)

文件夹的大小上限（以字节为单位）。
assetCount

string (int64 format)

文件夹中存储的素材资源数量。
maxAssets

string (int64 format)

文件夹中可存储的资产数量上限。
maxAssetCount
(deprecated)

string (int64 format)

文件夹中可存储的资产数量上限。

图块集

一组可通过唯一 ID 引用的 ImageSource。

JSON 表示法 
{
  "id": string,
  "sources": [
    {
      object (ImageSource)
    }
  ],
  "dataType": enum (DataType),
  "crs": string
}
字段
id

string

图块集的 ID。在 ImageManifest 中指定的所有图块集中必须是唯一的。此 ID 在处理步骤中会被舍弃；它仅用于将 Tileset 关联到频段。空字符串是有效的 ID。
sources[]

object (ImageSource)

构成相应图块集的来源。
dataType

enum (DataType)

频段的可选数据类型。如果指定了此参数，系统不会检查以验证每个输入文件的类型是否匹配。dataType 必须与每个输入文件的类型匹配，但输入类型不明确的情况除外（例如，Byte 可以是 INT8 或 UINT8）。
crs

string

像素网格的坐标参考系统，尽可能以标准代码指定，否则以 WKT 格式指定。

ImageSource

图片文件及其边车文件。

JSON 表示法 
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
字段
uris[]

string

要导入的数据的 URI。目前，仅支持 Google Cloud Storage URI。每个 URI 都必须采用以下格式指定：“gs://bucket-id/object-id”。主要对象应是列表中的第一个元素，然后列出边车。如果已设置，则每个 URI 都以 ImageManifest.uri_prefix 为前缀。
affineTransform

object (AffineTransform)

可选的仿射转换。仅当 uris 中的数据（包括任何边车）不足以放置像素时才应指定。
dimensions

object (GridDimensions)

光栅尺寸（以像素为单位）。仅在设置了“skipMetadataRead”时使用。

DataType

指定数值数据类型。

枚举
DATA_TYPE_UNSPECIFIED 未指定。
INT8 8 位有符号整数。
UINT8 8 位无符号整数。
INT16 16 位有符号整数。
UINT16 16 位无符号整数。
INT32 32 位有符号整数。
UINT32 32 位无符号整数。
FLOAT 32 位浮点数。
DOUBLE 64 位浮点数。

方法

copy

 复制资源。

create

 创建资产。

delete

 删除资源。

get

 获取有关资产的详细信息。

getIamPolicy

 获取资源的访问权限控制政策。

getPixels

 从图片素材资源中提取像素。

listAssets

 列出任何容器资产，例如文件夹或集合。

listFeatures

 列出表格资源中的功能。

listImages

 列出图片集合素材资源中的图片。

move

 移动资源。

patch

 更新资产。

setIamPolicy

 针对指定资源设置访问权限控制政策。

testIamPermissions

 返回调用者对指定资源拥有的权限。