Method: projects.map.export

Bắt đầu một quy trình xử lý hàng loạt để tính toán bản đồ xếp kề và ghi kết quả vào Google Cloud Storage.

Yêu cầu HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/map:export

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

Tham số đường dẫn

Thông số
project

string

Mã dự án hoặc số dự án của dự án Google Cloud Platform sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.

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

  • earthengine.exports.create

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
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "tileOptions": {
    object (TileOptions)
  },
  "tileExportOptions": {
    object (ImageFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
Trường
expression

object (Expression)

Một biểu thức đánh giá thành hình ảnh để tính toán và xuất. Ranh giới của hình ảnh sẽ được dùng để xác định tập hợp thẻ thông tin bản đồ cần kết xuất. Để kiểm soát vùng được xuất, hãy cắt hình ảnh trước khi xuất.

description

string

Tên công việc mà con người đọc được.

tileOptions

object (TileOptions)

Các tuỳ chọn mô tả thẻ thông tin bản đồ cần tạo.

tileExportOptions

object (ImageFileExportOptions)

Các tuỳ chọn về vị trí và định dạng xuất thẻ thông tin bản đồ. Cloud Storage hiện là đích đến duy nhất được hỗ trợ để xuất bản đồ.

requestId

string

Một chuỗi duy nhất dùng để phát hiện các yêu cầu trùng lặp. Nếu cùng một người dùng thực hiện nhiều yêu cầu với cùng một requestId không trống, thì chỉ một trong các yêu cầu đó mới có thể bắt đầu thành công một thao tác chạy trong thời gian dài. requestId có thể chứa các ký tự a..z, A..Z, 0-9 hoặc "-". requestId có thể dài tối đa 60 ký tự.

workloadTag

string

Nhãn do người dùng cung cấp để theo dõi phép tính này.

priority

integer

Không bắt buộc. Mức độ ưu tiên của tác vụ xuất trong dự án. Các tác vụ có mức độ ưu tiên cao hơn sẽ được lên lịch sớm hơn. Phải là số nguyên từ 0 đến 9999. Mặc định là 100 nếu không được đặt.

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

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
  • https://www.googleapis.com/auth/devstorage.full_control

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

TileOptions

Các tuỳ chọn mô tả thẻ thông tin hình ảnh hoặc video trên bản đồ cần xuất.

Biểu diễn dưới dạng JSON
{
  "startZoom": integer,
  "skipEmpty": boolean,
  "mapsApiKey": string,
  "dimensions": {
    object (GridDimensions)
  },
  "stride": integer,
  "zoomSubset": {
    object (ZoomSubset)
  },

  // Union field end_zoom_or_scale can be only one of the following:
  "endZoom": integer,
  "scale": number
  // End of list of possible types for union field end_zoom_or_scale.
}
Trường
startZoom

integer

Cấp độ thu phóng để bắt đầu tạo thẻ thông tin bản đồ để xuất. Giá trị mặc định là 0.

skipEmpty

boolean

Nếu là true, hãy bỏ qua việc ghi thẻ thông tin bản đồ trống (tức là hoàn toàn trong suốt).

mapsApiKey

string

Khoá API Google Maps Platform (không bắt buộc) cho trình xem thẻ thông tin bản đồ được tạo.

dimensions

object (GridDimensions)

Chiều rộng và chiều cao của ô video đầu ra, chỉ dùng để xuất kim tự tháp video xếp kề (ExportVideoMap).

stride

integer

Khoảng cách giữa các hàng và cột xếp kề. (ExportVideoMap) Đặt thành 4 cho các thẻ thông tin thưa thớt (chỉ dành cho WebGL) hoặc 1 (mặc định) để đạt được khả năng tương thích tối đa.

zoomSubset

object (ZoomSubset)

Một tập hợp con các mức thu phóng để tạo thẻ thông tin. Chỉ có thể được chỉ định trong lệnh gọi đến ExportVideoMap.

Trường hợp hợp nhất end_zoom_or_scale. Cấp độ thu phóng hoặc tỷ lệ mà tại đó bạn sẽ ngừng tạo thẻ thông tin bản đồ. Bạn phải chỉ định một trong hai thuộc tính này. end_zoom_or_scale chỉ có thể là một trong những giá trị sau:
endZoom

integer

Mức thu phóng để ngừng tạo ô bản đồ.

scale

number

Độ phân giải hình ảnh tối đa tính bằng mét trên pixel. Tỷ lệ sẽ được chuyển đổi thành mức thu phóng tối đa phù hợp nhất ở đường xích đạo.

ZoomSubset

Một tập hợp con các mức thu phóng để tạo thẻ thông tin (ExportVideoMap), Tập hợp con bắt đầu và kết thúc là các giá trị có độ chính xác kép, cho phép bạn hiển thị mức thu phóng hoặc các mức thu phóng tăng dần. Để kết xuất toàn bộ kim tự tháp với mức thu phóng bắt đầu là 12: startZoom=0, endZoom=12, đừng đặt thông báo này. Để kết xuất cấp 0-11 và 10% đầu tiên của cấp 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Để kết xuất 10% tiếp theo của cấp 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Để kết xuất 80% còn lại của cấp 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Ngoài ra, lưu ý rằng tất cả các mảnh xuất phải có cùng kích thước kim tự tháp (đầy đủ) trong start/endZoom.

Biểu diễn dưới dạng JSON
{
  "start": number,
  "end": number
}
Trường
start

number

Bắt đầu tập hợp con cấp độ thu phóng để tạo thẻ thông tin (ExportVideoMap) Tại đây, tập hợp con là một giá trị có độ chính xác kép, cho phép bạn kết xuất một cấp độ thu phóng tăng dần, ví dụ: 12,1 là 10% đầu tiên của các thẻ thông tin ở mức thu phóng 12 theo một thứ tự không xác định nhưng có thể xác định.

end

number

Kết thúc tập hợp con mức thu phóng để tạo thẻ thông tin (ExportVideoMap), cho phép bạn hiển thị mức thu phóng tăng dần, lên đến nhưng không bao gồm tập hợp con tối đa (nếu có) theo một thứ tự không xác định nhưng xác định.