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

  // Union field location can be only one of the following:
  "cloudStorageLocation": {
    object (CloudStorageLocation)
  },
  "gcsLocation": {
    object (GcsLocation)
  },
  "featureViewAssetLocation": {
    object (FeatureViewLocation)
  }
  // End of list of possible types for union field location.
}
字段
type

enum (Type)

资源的类型。

name

string

资产的名称。name 采用“projects/*/assets/**”格式(例如“projects/earthengine-legacy/assets/users//”)。

id

string

素材资源的 ID。等同于去掉“projects/*/assets/”前缀的 name(例如“users//”)。请注意,此设置仅用于显示目的。不应将其用作其他操作的输入。请改用 name

updateTime

string (Timestamp format)

资产的上次修改时间。

采用 RFC 3339 标准,生成的输出将始终在末尾带 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,并使用 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,并使用 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 所有的存储空间检索的。

联合字段 location。有关栅格图块的存储位置和方式的信息。location 只能是下列其中一项:
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

已弃用。请改用 image.importExternal。如需了解详情,请参阅 https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff

gcsLocation
(deprecated)

object (GcsLocation)

已弃用。请改用 image.importExternal。如需了解详情,请参阅 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 顺序排名的排名规则。

thinningRankingRule

object (RankingRule)

用于为地图项分配细化排名的排名规则。

RankingRule

用于控制地图项在进行细化和排列 z 轴顺序时如何排名的排名规则。

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

object (RankByOneThingRule)

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

RankByOneThingRule

用于控制细化和 z 顺序排名的单独排名规则。

JSON 表示法
{

  // Union field rule can be only one of the following:
  "rankByAttributeRule": {
    object (RankByAttributeRule)
  },
  "rankByMinVisibleLodRule": {
    object (RankByMinVisibleLodRule)
  },
  "rankByGeometryTypeRule": {
    object (RankByGeometryTypeRule)
  },
  "rankByMinZoomLevelRule": {
    object (RankByMinZoomLevelRule)
  }
  // End of list of possible types for union field rule.
  "direction": enum (Direction)
}
字段
联合字段 rule。要使用的排名规则类型。rule 只能是下列其中一项:
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 中。

方向

是按从低到高(升序)还是从高到低(降序)的顺序对列表进行排序。

枚举
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 会在处理步骤中舍弃;它仅用于将图块集与波段相关联。空字符串是有效的 ID。

sources[]

object (ImageSource)

构成此图块集的来源。

dataType

enum (DataType)

频段的可选数据类型。如果指定,系统不会进行任何检查来验证每个输入文件的类型是否匹配。dataType 必须与每个输入文件的类型匹配,但在输入类型不明确的情况下除外(例如,Byte 可以是 INT8UINT8)。

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

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