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 日期/時間,以 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)

依據地圖項目幾何圖形首次顯示時的 min_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

這個類型沒有任何欄位。

依據地圖項目幾何圖形首次顯示時的 min_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,因為它只用於將圖塊集連結至頻帶。空字串是有效的 ID。

sources[]

object (ImageSource)

這個圖塊集的來源。

dataType

enum (DataType)

頻帶的選用資料類型。如果指定此選項,系統就不會檢查每個輸入檔案的類型是否相符。dataType 必須與每個輸入檔案的類型相符,但輸入類型不明確的情況除外 (例如 Byte 可以是 INT8UINT8)。

crs

string

像素格線的座標參考系統,請盡可能指定為標準代碼,否則請使用 WKT 格式。

圖片來源

圖片檔案及其 sidecar。

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

傳回呼叫者在指定資源上擁有的權限。