Method: projects.assets.getPixels

Tìm nạp pixel từ một thành phần hình ảnh. Phương thức tuỳ chỉnh này cho phép phương thức gọi yêu cầu một ô pixel tuỳ ý từ một hình ảnh, tuỳ ý chỉ định các dải và phép chiếu bản đồ. Dữ liệu bị che hoặc bị thiếu sẽ được mã hoá thành số 0.

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

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu pixel được yêu cầu theo cách mã hoá được chỉ định trong trường fileFormat của yêu cầu.

Yêu cầu HTTP

POST https://earthengine.googleapis.com/v1beta/{name=projects/*/assets/**}:getPixels

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

Tham số đường dẫn

Thông số
name

string

Bắt buộc. Tên của thành phần hình ảnh để lấy pixel. name có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tất cả tài sản do người dùng sở hữu đều thuộc dự án "earthengine-legacy" (ví dụ: "projects/earthengine-legacy/assets/users/foo/bar"). Tất cả các tài sản khác đều thuộc dự án "earthengine-public" (ví dụ: "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

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 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Trường
fileFormat

enum (ImageFileFormat)

Định dạng tệp đầu ra để trả về các giá trị pixel.
grid

object (PixelGrid)

Các tham số mô tả lưới pixel để tìm nạp dữ liệu. Mặc định là lưới pixel gốc của dữ liệu.
region

object (Struct format)

Nếu có, vùng dữ liệu cần trả về, được chỉ định dưới dạng đối tượng hình học GeoJSON (xem RFC 7946). Vì hình ảnh được trả về luôn có hình chữ nhật, nên hộp giới hạn của hình học đã cho trong hệ toạ độ đầu ra sẽ được sử dụng. Nếu bạn cũng chỉ định grid.dimensions, thì lưới sẽ được điều chỉnh theo tỷ lệ thành kích thước được yêu cầu.
bandIds[]

string

Nếu có, hãy chỉ định một nhóm băng cụ thể để lấy pixel. Các dải được xác định bằng mã nhận dạng, như được chỉ ra trong trường id của nguyên mẫu ImageBand.
visualizationOptions

object (VisualizationOptions)

Nếu có, một tập hợp các tuỳ chọn trực quan hoá để áp dụng nhằm tạo hình ảnh trực quan RGB 8 bit của dữ liệu, thay vì trả về dữ liệu thô.
workloadTag

string

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

Nội dung phản hồi

Nếu thành công, phản hồi sẽ là một phản hồi HTTP chung có định dạng do phương thức xác định.

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.