Cập nhật một tài sản. Hoạt động cập nhật có một số quy tắc ràng buộc:
- Bạn chỉ có thể cập nhật các trường
title,description,startTime,endTimevàpropertiescủa tài sản. - Việc đặt tên
"properties"trongupdateMasksẽ khiến tất cả các thuộc tính do người dùng xác định của thành phần được thay thế bằng các thuộc tính trongasset. - Việc đặt tên
"title","description","startTime"hoặc"endTime"trongupdateMaskvà không cung cấp giá trị trongassetsẽ khiến trường đó trở thành trường chưa được đặt. - Bạn có thể cập nhật từng thuộc tính bằng cách đặt tên cho chúng 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.propertieshoặ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 một
NullValue. - Việc cung cấp một
updateMasktrống sẽ khiến dấu thời gian và thuộc tính 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/v1/{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 của tài sản. |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu với 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 tài sản. |
asset.id |
Mã nhận dạng của thành phần. Tương đương với |
asset.updateTime |
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ụ: |
asset.properties |
Các thuộc tính khoá/giá trị được liên kết với tài sản. |
asset.startTime |
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ụ: |
asset.endTime |
Đố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ụ: |
asset.geometry |
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). |
asset.bands[] |
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. |
asset.sizeBytes |
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. |
asset.featureCount |
Số lượng đặc điểm trong tài sản (nếu có). |
asset.quota |
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/*"). |
asset.tilesets[] |
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. |
updateMask |
Mặt nạ cập nhật chỉ định những trường của tài sản cần cập nhật. Đây là danh sách tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: |
| 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: | |
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. |
| Kết thúc các trường xung khắc. | |
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 thực thể 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/earthenginehttps://www.googleapis.com/auth/cloud-platform
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.