REST Resource: projects.assets

資源：EarthEngineAsset

Earth Engine 資產的相關資訊。

JSON 表示法 
{
  "type": enum (Type),
  "name": string,
  "id": string,
  "updateTime": 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)
  },
  "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。等同於 name，但不含「projects/*/assets/」前置字元 (例如「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"。
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)

已淘汰，請改用 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 錯誤。

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 日期/時間，以 Epoch 紀元時間起算的微秒數表示，因此支援從西元前 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)

零或多個「依一項事物排序」(例如屬性) 規則的排序清單，做為主要、次要等排序鍵，用於在每個 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
}
欄位
sizeBytes

string (int64 format)

資料夾大小 (以位元組為單位)。
maxSizeBytes

string (int64 format)

資料夾大小上限 (以位元組為單位)。
assetCount

string (int64 format)

資料夾中儲存的資產數量。
maxAssets

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 可以是 INT8 或 UINT8)。
crs

string

像素格線的座標參考系統，盡可能以標準代碼指定，否則以 WKT 格式指定。

圖片來源

圖片檔案和附屬檔案。

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

 列出表格資產中的特徵。

move

 移動資產。

patch

 更新資產。

setIamPolicy

 設定指定資源的存取控管政策。

testIamPermissions

 傳回呼叫端對指定資源所擁有的權限。