Tạo một mã nhận dạng có thể dùng để hiển thị hình ảnh "hình thu nhỏ".
Phương thức này được dùng cùng với GetThumbnailPixels. Lệnh gọi đến thumbnails.create cung cấp một biểu thức và một số tuỳ chọn đầu ra. Kết quả của thumbnails.create là một mã nhận dạng đại diện cho hình ảnh là kết quả của việc đánh giá biểu thức đó và áp dụng các tuỳ chọn đó. Sau đó, bạn có thể thực hiện lệnh gọi đến GetThumbnailPixels để lấy dữ liệu hình ảnh cho toàn bộ hình ảnh thu được. Giấy tờ tuỳ thân này sẽ có hiệu lực trong một khoảng thời gian vừa phải (vài giờ).
Trường hợp sử dụng phổ biến nhất cho cặp điểm cuối này là cung cấp một biểu thức phức tạp thông qua một yêu cầu POST đến thumbnails.create, sau đó tìm nạp hình ảnh được tính toán thông qua một yêu cầu GET đến GetThumbnailPixels. Quy trình hai phần này cho phép sử dụng trong nhiều trường hợp hơn so với ComputePixels. Cụ thể: – kết quả của ComputePixels cần được mở gói để lấy các byte hình ảnh đã mã hoá. Trình duyệt có thể hiển thị trực tiếp kết quả của GetThumbnailPixels. – Chỉ người dùng được uỷ quyền mới có thể gọi ComputePixels bằng mã thông báo OAuth có phạm vi thích hợp. thumbnails.create có cùng quy định hạn chế, nhưng GetThumbnailPixels có thể được gọi bằng một URL chứa khoá API, vì vậy, các URL gọi API này có thể được sử dụng rộng rãi hơn.
Kết quả của việc đánh giá biểu thức phải đáp ứng một số yêu cầu hợp lý đối với định dạng hình ảnh được yêu cầu. Cụ thể, định dạng JPEG hoặc PNG yêu cầu phải có một hoặc ba dải đầu ra và các giá trị clip nằm ngoài phạm vi 0-255.
Nội dung mô tả "hình thu nhỏ" không ngụ ý giới hạn về kích thước của hình ảnh được tính toán: các giới hạn giống như ComputePixels áp dụng cho thumbnails.create/GetThumbnailPixels. Mỗi yêu cầu được giới hạn ở 48 MB dữ liệu không nén, được tính bằng tích của kích thước yêu cầu tính bằng pixel, số dải hình ảnh được yêu cầu và số byte trên mỗi pixel cho mỗi dải. Các yêu cầu cũng bị giới hạn ở tối đa 32K pixel theo một trong hai kích thước và tối đa 1024 băng tần. Các yêu cầu vượt quá các giới hạn này sẽ dẫn đến mã lỗi 400 (BAD_REQUEST).
Yêu cầu HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/thumbnails
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số | |
|---|---|
parent |
Bắt buộc. Phần tử mẹ của bộ sưu tập hình thu nhỏ (ví dụ: "projects/*"). Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên
|
Tham số truy vấn
| Thông số | |
|---|---|
workloadTag |
Thẻ do người dùng cung cấp để theo dõi phép tính này. |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Thumbnail.
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ể Thumbnail mới tạo.
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/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.