Method: projects.locations.maps.create

Tạo một mã nhận dạng có thể dùng để kết xuất thẻ thông tin bản đồ cho thấy kết quả của một phép tính. Bạn nên sử dụng mã nhận dạng thu được trong các yêu cầu GetTile.

Phương thức này được dùng cùng với GetTile. Lệnh gọi đến maps.create cung cấp một biểu thức và một số tuỳ chọn đầu ra. Kết quả của maps.create là một mã bản đồ đạ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 GetTile để lấy dữ liệu hình ảnh cho một ô của hình ảnh thu được, ở bất kỳ vị trí và mức thu phóng nào mong muốn. Mã bản đồ 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à điền sẵn khung nhìn bản đồ bằng hình ảnh trực quan của kết quả của một số phép tính. Để có thể thực hiện việc đó, kết quả tính toán 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.

Yêu cầu HTTP

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/maps

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

Bắt buộc. Thành phần mẹ của tập hợp bản đồ (ví dụ: "projects/*").

Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên parent đã chỉ định:

  • earthengine.maps.create

Tham số truy vấn

Thông số
workloadTag

string

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 EarthEngineMap.

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ể EarthEngineMap 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/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.