REST Resource: projects.assets

Tài nguyên: EarthEngineAsset

Thông tin về một tài sản trên Earth Engine.

Biểu diễn dưới dạng 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)
    }
  ],

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

enum (Type)

Loại tài sản.

name

string

Tên của tài sản. name có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users//").

id

string

Mã nhận dạng của thành phần. Tương đương với name mà không có tiền tố "projects/*/assets/" (ví dụ: "users//"). Xin lưu ý rằng thông tin này chỉ nhằm mục đích hiển thị. Bạn không nên dùng mã này làm dữ liệu đầu vào cho một thao tác khác. Thay vào đó, hãy sử dụng name.

updateTime

string (Timestamp format)

Thời gian sửa đổi gần đây nhất của tài sản.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

properties

object (Struct format)

Các thuộc tính khoá/giá trị được liên kết với tài sản.

startTime

string (Timestamp format)

Dấu thời gian được liên kết với thành phần, nếu có, ví dụ: thời điểm chụp ảnh vệ tinh. Đối với những tài sản tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm bắt đầu của khoảng thời gian đó.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Đối với những tài sản tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với cuối khoảng thời gian đó (không bao gồm).

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

geometry

object (Struct format)

Phạm vi không gian được liên kết với tài sản (nếu có), dưới dạng đối tượng hình học GeoJSON (xem RFC 7946).

bands[]

object (ImageBand)

Thông tin về các dải dữ liệu của thành phần hình ảnh. Bị bỏ qua đối với thành phần không phải là hình ảnh.

sizeBytes

string (int64 format)

Kích thước của một thành phần tài sản lá (ví dụ: hình ảnh) tính bằng byte.

featureCount

string (int64 format)

Số lượng đặc điểm trong tài sản (nếu có).

quota

object (FolderQuota)

Thông tin về hạn mức liên kết với tài sản thư mục (nếu có). Trả về cho các thành phần thư mục cấp cao nhất do người dùng sở hữu (ví dụ: "users/*" hoặc "projects/*").

tilesets[]

object (Tileset)

Các nhóm ô hỗ trợ hình ảnh này. Chỉ xuất hiện đối với hình ảnh bên ngoài, có các pixel được truy xuất từ bộ nhớ không thuộc quyền sở hữu của Earth Engine.

Thông tin về vị trí và cách lưu trữ các ô raster. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
cloudStorageLocation
(deprecated)

object (CloudStorageLocation)

Không dùng nữa. Thay vào đó, hãy sử dụng ImportExternalImage. Hãy xem https://developers.google.com/earth-engine/Earth_Engine_asset_from_cloud_geotiff để biết thêm thông tin.

featureViewAssetLocation

object (FeatureViewLocation)

Vị trí của FeatureView này trong EE.

Kết thúc các trường xung khắc.

CloudStorageLocation

Vị trí của một tài sản trên Cloud Storage.

Biểu diễn dưới dạng JSON
{
  "uris": [
    string
  ]
}
Trường
uris[]

string

URI của dữ liệu. Hệ thống chỉ hỗ trợ URI Google Cloud Storage. Bạn phải chỉ định từng URI theo định dạng sau: "gs://bucket-id/object-id". Hiện tại, chúng tôi chỉ hỗ trợ một URI. Nếu bạn chỉ định nhiều URI, thì lỗi INALID_ARGUMENT sẽ được trả về.

FeatureViewLocation

Một thành phần FeatureView EE.

Biểu diễn dưới dạng JSON
{
  "assetOptions": {
    object (FeatureViewOptions)
  }
}
Trường
assetOptions

object (FeatureViewOptions)

Các lựa chọn trong thời gian nhập cho thành phần FeatureView.

FeatureViewOptions

Các lựa chọn trong thời gian nhập cho thành phần FeatureView.

Biểu diễn dưới dạng JSON
{
  "featureViewAttributes": [
    {
      object (FeatureViewAttribute)
    }
  ],
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  }
}
Trường
featureViewAttributes[]

object (FeatureViewAttribute)

Các thuộc tính trong tài sản FeatureView, bao gồm một giản đồ cho tài sản. Đây là những thuộc tính mà các đối tượng trong tài sản này có thể có. Mỗi thuộc tính đều có tên và loại.

ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Các tham số thời gian truyền FeatureView.

FeatureViewAttribute

Một thuộc tính FeatureView và loại của thuộc tính đó.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "type": enum (Type)
}
Trường
name

string

Tên của thuộc tính.

type

enum (Type)

Loại thuộc tính.

Loại

Các loại này là bản sao của những loại có trong geo/enterprise/layers/public/data_source_schema.proto.

Enum
TYPE_UNSPECIFIED Chưa chỉ định loại.
INTEGER Giá trị số nguyên 64 bit.
BOOLEAN Giá trị Boolean True/False.
DOUBLE Số có dấu phẩy động có độ chính xác gấp đôi.
STRING Một chuỗi có độ dài không giới hạn.
DATE_TIME Ngày/giờ, được biểu thị dưới dạng số nguyên 64 bit có dấu tính bằng micrô giây kể từ thời gian bắt đầu của hệ thống, do đó hỗ trợ khoảng thời gian từ năm 290.308 trước Công nguyên đến năm 294.247 sau Công nguyên.

FeatureViewIngestionTimeParameters

Các tham số thời gian truyền FeatureView. Bạn phải chỉ định các tham số này tại thời điểm tiếp nhận và không thể cập nhật ngay cho FeatureView.

Biểu diễn dưới dạng JSON
{
  "thinningOptions": {
    object (ThinningOptions)
  },
  "rankingOptions": {
    object (RankingOptions)
  }
}
Trường
thinningOptions

object (ThinningOptions)

Số lượng tối đa các hộp giới hạn đối tượng được phép giao nhau với một ô. Số này không được là số âm.

rankingOptions

object (RankingOptions)

Các lựa chọn để chỉ định thứ hạng theo thứ tự z và thứ hạng làm mỏng cho các đối tượng.

ThinningOptions

Các lựa chọn tinh giản giúp kiểm soát mật độ mà các đối tượng được hiển thị trên mỗi ô.

Biểu diễn dưới dạng JSON
{
  "maxFeaturesPerTile": integer,
  "thinningStrategy": enum (ThinningStrategy)
}
Trường
maxFeaturesPerTile

integer

Số lượng tối đa các hộp giới hạn đối tượng được phép giao nhau với một ô. Số này không được là số âm.

thinningStrategy

enum (ThinningStrategy)

Chiến lược giảm số lượng đối tượng cần sử dụng.

ThinningStrategy

Chiến lược tinh giản cho các tính năng.

Enum
UNKNOWN_THINNING_STRATEGY Chiến lược giảm kích thước không xác định.
GLOBALLY_CONSISTENT Khi giảm độ chi tiết ở một LOD cụ thể, việc giảm độ chi tiết nhất quán trên toàn cầu có nghĩa là nếu một đối tượng bị xoá do giảm độ chi tiết, thì tất cả các đối tượng khác có thứ hạng giảm độ chi tiết bằng hoặc thấp hơn cũng sẽ bị xoá.
HIGHER_DENSITY

Khi làm mỏng, hãy cố gắng đạt gần đến giới hạn maxFeaturesPerTile cho mỗi ô. Chúng tôi sẽ ưu tiên các đối tượng được xếp hạng cao hơn so với các đối tượng được xếp hạng thấp hơn, nhưng đôi khi sẽ loại bỏ các đối tượng được xếp hạng cao hơn nếu điều đó giúp chúng tôi đạt được mật độ đối tượng cao hơn.

Chúng tôi đảm bảo rằng chiến lược này là xác định và tập hợp các đối tượng sau khi được làm mỏng sẽ là một tập hợp lớn hơn các đối tượng được tạo bằng cách làm mỏng nhất quán trên toàn cầu.

RankingOptions

Các lựa chọn xếp hạng cho thứ tự z và việc làm mỏng.

Biểu diễn dưới dạng JSON
{
  "zOrderRankingRule": {
    object (RankingRule)
  },
  "thinningRankingRule": {
    object (RankingRule)
  }
}
Trường
zOrderRankingRule

object (RankingRule)

Quy tắc xếp hạng để chỉ định thứ hạng theo thứ tự z cho các đối tượng.

thinningRankingRule

object (RankingRule)

Quy tắc xếp hạng để chỉ định thứ hạng làm mỏng cho các đối tượng.

RankingRule

Các quy tắc xếp hạng kiểm soát cách các đối tượng được xếp hạng để làm mỏng và sắp xếp theo thứ tự z.

Biểu diễn dưới dạng JSON
{
  "rankByOneThingRule": [
    {
      object (RankByOneThingRule)
    }
  ]
}
Trường
rankByOneThingRule[]

object (RankByOneThingRule)

Danh sách có thứ tự gồm 0 hoặc nhiều quy tắc xếp hạng theo một tiêu chí (chẳng hạn như một thuộc tính), được dùng làm khoá xếp hạng chính, phụ, ... để đặt thinning_rank trong mỗi RankedFeature.

RankByOneThingRule

Một quy tắc xếp hạng riêng lẻ để kiểm soát thứ hạng cho việc giảm số lượng và thứ tự z.

Biểu diễn dưới dạng 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)
}
Trường
Loại quy tắc xếp hạng cần sử dụng. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
rankByAttributeRule

object (RankByAttributeRule)

Xếp hạng theo giá trị thuộc tính của đối tượng.

rankByMinVisibleLodRule
(deprecated)

object (RankByMinVisibleLodRule)

Xếp hạng theo LOD tối thiểu mà hình học đối tượng xuất hiện lần đầu. Một đối tượng có bất kỳ điểm nào sẽ luôn hiển thị ở mọi LOD. Không dùng nữa: vui lòng sử dụng rankByMinZoomLevelRule.

rankByGeometryTypeRule

object (RankByGeometryTypeRule)

Xếp hạng theo loại hình học. Mức độ ưu tiên của các loại, từ cao đến thấp: đa giác, đường đa tuyến, điểm, không có. Trong các đối tượng có nhiều loại, loại cao nhất sẽ được ưu tiên.

rankByMinZoomLevelRule

object (RankByMinZoomLevelRule)

Xếp hạng theo mức thu phóng tối thiểu mà hình học đối tượng lần đầu tiên xuất hiện. Một đối tượng có bất kỳ điểm nào sẽ luôn hiển thị ở mọi LOD.

Kết thúc các trường xung khắc.
direction

enum (Direction)

Liệu thứ hạng theo một yếu tố này phải là ASCENDING (giá trị thấp hơn trước, tức là quan trọng hơn) hay DESCENDING (giá trị cao hơn trước, tức là quan trọng hơn). Nói cách khác, ASCENDING có nghĩa là sử dụng trực tiếp thứ tự được mô tả trong tài liệu về thông báo phụ RankByAttributeRule (hoặc thông báo phụ khác) bên dưới, còn DESCENDING có nghĩa là đảo ngược thứ tự đó.

RankByAttributeRule

Xếp hạng theo giá trị thuộc tính của đối tượng.

Biểu diễn dưới dạng JSON
{
  "attributeName": string
}
Trường
attributeName

string

Xếp hạng theo giá trị của thuộc tính có tên đã cho. Đây chủ yếu là thứ tự tự nhiên của các giá trị thuộc loại đã cho, với một số điểm tinh tế và nội dung làm rõ: – đối với các thuộc tính số nguyên, giá trị thấp hơn sẽ xuất hiện trước giá trị cao hơn – đối với các thuộc tính số thực, giá trị thấp hơn sẽ xuất hiện trước giá trị cao hơn với NaN được coi là thấp hơn tất cả các giá trị khác, kể cả vô cực âm – đối với các thuộc tính boolean, giá trị false được coi là xuất hiện trước giá trị true – đối với các thuộc tính date_time, giá trị trước đó sẽ xuất hiện trước giá trị sau – các thuộc tính chuỗi được xếp hạng theo từ điển học – một thuộc tính chưa được đặt giá trị sẽ được coi là có giá trị mặc định của loại đã cho (0 đối với số nguyên, false đối với boolean, v.v.).

RankByMinVisibleLodRule

Loại này không có trường nào.

Xếp hạng theo LOD tối thiểu mà hình học đối tượng xuất hiện lần đầu. Một đối tượng có bất kỳ điểm nào sẽ luôn hiển thị ở mọi LOD.

RankByGeometryTypeRule

Loại này không có trường nào.

Xếp hạng theo loại hình học. Mức độ ưu tiên của các loại, từ cao đến thấp: đa giác, đường đa tuyến, điểm, không có. Trong các đối tượng có nhiều loại, loại cao nhất sẽ được ưu tiên.

RankByMinZoomLevelRule

Loại này không có trường nào.

Xếp hạng theo mức thu phóng tối thiểu mà hình học đối tượng lần đầu tiên xuất hiện. Một đối tượng có bất kỳ điểm nào sẽ luôn hiển thị ở mọi LOD.

Hướng

Có sắp xếp danh sách từ thấp đến cao (TĂNG DẦN) hay từ cao đến thấp (GIẢM DẦN) hay không.

Enum
DIRECTION_UNSPECIFIED Không chỉ định hướng xếp hạng.
ASCENDING Thứ tự tăng dần.
DESCENDING Thứ tự giảm dần.

Loại

Các loại tài sản.

Enum
TYPE_UNSPECIFIED Không xác định.
IMAGE Hình ảnh.
IMAGE_COLLECTION Bộ sưu tập hình ảnh.
TABLE Bảng.
FOLDER Thư mục.
CLASSIFIER Công cụ phân loại.
FEATURE_VIEW Thành phần FeatureView.

ImageBand

Thông tin về một dải dữ liệu của thành phần hình ảnh.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "dataType": {
    object (PixelDataType)
  },
  "grid": {
    object (PixelGrid)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "missingData": {
    object (MissingData)
  }
}
Trường
id

string

Mã nhận dạng của ban nhạc.

dataType

object (PixelDataType)

Loại số của dải tần.

grid

object (PixelGrid)

Lưới pixel của dải màu.

pyramidingPolicy

enum (PyramidingPolicy)

Chính sách về việc cộng dồn của ban nhạc.

missingData

object (MissingData)

(Các) giá trị biểu thị dữ liệu bị thiếu.

PixelDataType

Chỉ định loại số của các pixel trong một dải hình ảnh.

Biểu diễn dưới dạng JSON
{
  "precision": enum (Precision),
  "range": {
    object (DoubleRange)
  },
  "dimensionsCount": integer
}
Trường
precision

enum (Precision)

Độ chính xác bằng số của loại.

range

object (DoubleRange)

Phạm vi của loại số (nếu có). Thường không có đối với các loại số thực dấu phẩy động.

dimensionsCount

integer

Số lượng phương diện trong kiểu dữ liệu có giá trị mảng hoặc bằng 0 để cho biết kiểu vô hướng thông thường.

Chính xác

Chỉ định độ chính xác của một kiểu dữ liệu dạng số.

Enum
PRECISION_UNSPECIFIED Không xác định.
INT Kiểu dữ liệu có độ chính xác số nguyên. Xin lưu ý rằng điều này có thể biểu thị các số nguyên có kích thước khác nhau.
FLOAT Loại dữ liệu này có độ chính xác dấu phẩy động 32 bit.
DOUBLE Kiểu dữ liệu này có độ chính xác dấu phẩy động (gấp đôi) 64 bit.

MissingData

Danh sách các giá trị đại diện cho việc không có dữ liệu.

Biểu diễn dưới dạng JSON
{
  "values": [
    number
  ]
}
Trường
values[]

number

Giá trị không đại diện cho dữ liệu.

FolderQuota

Mô tả mức sử dụng và hạn mức hiện tại của một thư mục cấp cao nhất.

Biểu diễn dưới dạng JSON
{
  "sizeBytes": string,
  "maxSizeBytes": string,
  "assetCount": string,
  "maxAssets": string
}
Trường
sizeBytes

string (int64 format)

Kích thước của thư mục tính bằng byte.

maxSizeBytes

string (int64 format)

Kích thước tối đa của thư mục tính bằng byte.

assetCount

string (int64 format)

Số lượng tài sản được lưu trữ trong thư mục.

maxAssets

string (int64 format)

Số lượng thành phần tối đa có thể lưu trữ trong thư mục.

Tileset

Một tập hợp ImageSource có thể được tham chiếu bằng một mã nhận dạng duy nhất.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "sources": [
    {
      object (ImageSource)
    }
  ],
  "dataType": enum (DataType),
  "crs": string
}
Trường
id

string

Mã nhận dạng của bộ ô. Phải là duy nhất trong số các nhóm ô được chỉ định trong ImageManifest. Mã nhận dạng này sẽ bị loại bỏ trong bước xử lý; mã này chỉ được dùng để liên kết một Nhóm ô với một dải tần. Chuỗi trống là một mã nhận dạng hợp lệ.

sources[]

object (ImageSource)

Các nguồn tạo nên tập hợp ô này.

dataType

enum (DataType)

Loại dữ liệu không bắt buộc cho dải tần. Nếu được chỉ định, hệ thống sẽ không kiểm tra để xác minh rằng loại của mọi tệp đầu vào đều khớp. dataType phải khớp với loại của mọi tệp đầu vào, ngoại trừ trường hợp loại đầu vào không rõ ràng (ví dụ: Byte có thể là INT8 hoặc UINT8).

crs

string

Hệ thống tham chiếu toạ độ của lưới pixel, được chỉ định dưới dạng mã tiêu chuẩn (nếu có thể) và ở định dạng WKT (nếu không).

ImageSource

Một tệp hình ảnh và các tệp đi kèm.

Biểu diễn dưới dạng JSON
{
  "uris": [
    string
  ],
  "affineTransform": {
    object (AffineTransform)
  },
  "dimensions": {
    object (GridDimensions)
  }
}
Trường
uris[]

string

URI của dữ liệu cần nhập. Hiện tại, chỉ các URI Google Cloud Storage mới được hỗ trợ. Bạn phải chỉ định từng URI theo định dạng sau: "gs://bucket-id/object-id". Đối tượng chính phải là phần tử đầu tiên trong danh sách, sau đó là các đối tượng phụ. Mỗi URI đều có tiền tố ImageManifest.uri_prefix nếu được đặt.

affineTransform

object (AffineTransform)

Một phép biến đổi á-phin không bắt buộc. Bạn chỉ nên chỉ định nếu dữ liệu từ uris (bao gồm cả mọi tệp phụ) không đủ để đặt các pixel.

dimensions

object (GridDimensions)

Kích thước của hình ảnh raster, tính bằng pixel. Chỉ được dùng khi bạn đặt "skipMetadataRead".

DataType

Chỉ định loại dữ liệu số.

Enum
DATA_TYPE_UNSPECIFIED Không xác định.
INT8 Số nguyên 8 bit có dấu.
UINT8 Số nguyên 8 bit không dấu.
INT16 Số nguyên 16 bit có dấu.
UINT16 Số nguyên 16 bit không dấu.
INT32 Số nguyên 32 bit có dấu.
UINT32 Số nguyên 32 bit chưa ký.
FLOAT Dấu phẩy động 32 bit.
DOUBLE Số thực 64 bit.

Phương thức

copy

Sao chép một thành phần.

create

Tạo một tài sản.

delete

Xoá một thành phần.

get

Lấy thông tin chi tiết về một tài sản.

getIamPolicy

Lấy chính sách kiểm soát quyền truy cập cho một tài nguyên.

getPixels

Tìm nạp các pixel từ một thành phần hình ảnh.

listAssets

Liệt kê mọi tài sản vùng chứa, chẳng hạn như thư mục hoặc bộ sưu tập.

listFeatures

Liệt kê các đối tượng trong một thành phần bảng.

move

Di chuyển một tài sản.

patch

Cập nhật một tài sản.

setIamPolicy

Đặt chính sách kiểm soát quyền truy cập cho tài nguyên được chỉ định.

testIamPermissions

Trả về các quyền mà người gọi có đối với tài nguyên được chỉ định.