Cập nhật một thành phần. Có một số quy tắc ràng buộc đối với thao tác cập nhật:
- Bạn chỉ có thể cập nhật các trường
title
,description
,startTime
,endTime
vàproperties
của thành phần. - Việc đặt tên
"properties"
trongupdateMask
sẽ dẫn đến việc tất cả thuộc tính do người dùng xác định của tài sản sẽ được thay thế bằng các thuộc tính trongasset
. - Việc đặt tên
"title"
,"description"
,"startTime"
hoặc"endTime"
trongupdateMask
và không cung cấp giá trị trongasset
sẽ khiến trường đó bị huỷ thiết lập. - Bạn có thể cập nhật từng thuộc tính riêng lẻ bằng cách đặt tên cho các thuộc tính đó trong
updateMask
, chẳng hạn như"properties.my_property_name"
. Giá trị của thuộc tính sẽ được đặt thành giá trị tương ứng từasset.properties
. Nếu không có giá trị tương ứng trongasset.properties
hoặc nếu có giá trị nhưng đó làNullValue
, thì thuộc tính sẽ bị xoá khỏi thành phần. - Bạn chỉ có thể đặt thuộc tính thành giá trị chuỗi hoặc số hoặc xoá bằng cách chỉ định
NullValue
. - Việc cung cấp
updateMask
trống sẽ dẫn đến việc tất cả các thuộc tính và dấu thời gian của thành phần đều được thay thế bằng các giá trị trongasset
.
Yêu cầu HTTP
PATCH https://earthengine.googleapis.com/v1beta/{asset.name=projects/*/assets/**}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số | |
---|---|
asset.name |
Tên nội dung. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "asset": { "cloudStorageLocation": { "uris": [ string ] }, "featureViewAssetLocation": { "assetOptions": { object ( |
Trường | |
---|---|
asset.type |
Loại thành phần. |
asset.id |
ID của nội dung. Tương đương với |
asset.updateTime |
Thời gian sửa đổi gần đây nhất của thành phần. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
asset.properties |
Các thuộc tính khoá/giá trị được liên kết với thành phần. |
asset.startTime |
Dấu thời gian liên kết với thành phần (nếu có), ví dụ: thời gian chụp ảnh vệ tinh. Đối với những thành phầ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 khoảng thời gian đó. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
asset.endTime |
Đối với những thành phầ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 kết thúc khoảng thời gian đó (không bao gồm). Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
asset.geometry |
Dấu vết không gian 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). |
asset.bands[] |
Thông tin về dải dữ liệu của thành phần hình ảnh. Bỏ qua đối với thành phần không phải hình ảnh. |
asset.sizeBytes |
Kích thước của một thành phần lá (ví dụ: hình ảnh) tính bằng byte. |
asset.featureCount |
Số lượng tính năng trong thành phần (nếu có). |
asset.quota |
Thông tin hạn mức liên kết với tài sản thư mục (nếu có). Đượ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/*"). |
asset.tilesets[] |
Các tập hợp thẻ thông tin hỗ trợ hình ảnh này. Chỉ xuất hiện đối với hình ảnh bên ngoài, có pixel được truy xuất từ bộ nhớ không thuộc sở hữu của Earth Engine. |
updateMask |
Mặt nạ cập nhật chỉ định những trường của thành phần cần cập nhật. Đây là danh sách tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: |
Trường hợp hợp nhất location . Thông tin về vị trí và cách lưu trữ các ô đường quét. location chỉ có thể là một trong những giá trị sau: |
|
asset.cloudStorageLocation |
Không dùng nữa. Thay vào đó, hãy sử dụng |
asset.featureViewAssetLocation |
Vị trí của FeatureView này trong EE. |
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của EarthEngineAsset
.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.