Method: projects.map.export

Khởi chạy một quy trình hàng loạt để tính toán bản đồ dạng ô và ghi kết quả vào Google Cloud Storage.

Yêu cầu HTTP

POST https://earthengine.googleapis.com/v1alpha/{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 cần được coi là người tiêu dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.

Để uỷ quyền, bạn cần có quyền IAM sau đây trên tài nguyên được chỉ định project:

  • earthengine.exports.create

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
{
  "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á 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 các ô 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 dễ đọc của việc cần làm.

tileOptions

object (TileOptions)

Các lựa chọn mô tả ô bản đồ cần tạo.

tileExportOptions

object (ImageFileExportOptions)

Các lựa chọn về vị trí và định dạng để xuất các ô bản đồ. Cloud Storage hiện là đích đến duy nhất được hỗ trợ cho việc 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 đưa ra nhiều yêu cầu có cùng requestId không trống, thì chỉ một trong số các yêu cầu đó có thể bắt đầu thành công một thao tác kéo 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 thực thể 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 lựa chọn mô tả ô bản đồ hình ảnh hoặc video để xuất.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "endZoom": integer,
  "maxZoom": integer,
  "scale": number
  // End of mutually exclusive fields.
}
Trường
startZoom

integer

Mức thu phóng để bắt đầu tạo ô bản đồ để xuất. Giá trị mặc định là 0.

minZoom
(deprecated)

integer

Mức thu phóng để bắt đầu tạo ô bản đồ để xuất. Giá trị mặc định là 0.

skipEmpty

boolean

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

skipEmptyTiles
(deprecated)

boolean

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

mapsApiKey

string

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

dimensions

object (GridDimensions)

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

tileDimensions
(deprecated)

object (GridDimensions)

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

stride

integer

Bước hàng và cột của ô. (ExportVideoMap) Đặt thành 4 cho các ô thưa (chỉ WebGL) hoặc 1 (mặc định) để có khả năng tương thích tối đa.

zoomSubset

object (ZoomSubset)

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

Mức thu phóng hoặc tỷ lệ mà bạn muốn dừng tạo ô bản đồ. Bạn phải chỉ định một trong hai thuộc tính này. 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:
endZoom

integer

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

maxZoom
(deprecated)

integer

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

scale

number

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

Kết thúc các trường xung khắc.

ZoomSubset

Một tập hợp con của các mức thu phóng để tạo ô (ExportVideoMap), Tập hợp con bắt đầu và kết thúc là các giá trị có độ chính xác gấp đôi, cho phép bạn kết xuất một hoặc nhiều mức thu phóng theo gia số. Để kết xuất toàn bộ kim tự tháp với mức thu phóng ban đầu là 12: startZoom=0, endZoom=12, đừng đặt thông báo này. Để hiển thị các cấp 0 – 11 và 10% đầu tiên của cấp 12: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } Để hiển thị 10% tiếp theo của cấp 12: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } Để hiển thị 80% còn lại của cấp 12: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } Ngoài ra, xin lưu ý rằng tất cả các phân đoạn xuất đều 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,
  "min": number,
  "max": number
}
Trường
start

number

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

end

number

Tập hợp con mức thu phóng kết thúc để tạo ô (ExportVideoMap), cho phép bạn kết xuất mức thu phóng tăng dần, tối đa nhưng không bao gồm tập hợp con tối đa (nếu được cung cấp) theo một số thứ tự không xác định nhưng có tính xác định.

min
(deprecated)

number

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

max
(deprecated)

number

Tập hợp con mức thu phóng kết thúc để tạo ô (ExportVideoMap), cho phép bạn kết xuất mức thu phóng tăng dần, tối đa nhưng không bao gồm tập hợp con tối đa (nếu được cung cấp) theo một số thứ tự không xác định nhưng có tính xác định.