Method: projects.assets.listImages

Liệt kê các hình ảnh trong thành phần bộ sưu tập hình ảnh. Phương thức này cho phép phương thức gọi áp dụng bộ lọc siêu dữ liệu và không gian thời gian cho một bộ sưu tập hình ảnh.

Yêu cầu HTTP

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages

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. Tên của thành phần bộ sưu tập hình ảnh cần liệt kê. parent 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 parent đã chỉ định:

  • earthengine.assets.get

Tham số truy vấn

Thông số
pageSize

integer

Số lượng kết quả tối đa trên mỗi trang. Máy chủ có thể trả về ít thành phần hơn so với yêu cầu. Nếu không chỉ định, kích thước trang mặc định sẽ phụ thuộc vào EarthEngineAssetView, với các giới hạn cao hơn cho các chế độ xem hạn chế hơn.

pageToken

string

Mã thông báo xác định trang kết quả mà máy chủ sẽ trả về. Thông thường, đây là giá trị của ListImagesResponse.next_page_token được trả về từ lệnh gọi trước đó đến phương thức assets.listImages.

startTime

string (Timestamp format)

Nếu có, bộ lọc sẽ lọc ra những kết quả có dấu thời gian ít nhất là giá trị này (bao gồm cả giá trị này).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Nếu có, bộ lọc sẽ lọc ra những kết quả có dấu thời gian nhỏ hơn giá trị này (không bao gồm).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

region

string

Nếu có, một hình học xác định vùng truy vấn, được chỉ định dưới dạng chuỗi hình học GeoJSON (xem RFC 7946). Điểm giao nhau không gian chính xác đến 1 mét.

filter

string

Nếu có, hãy chỉ định các bộ lọc tài sản đơn giản khác.

view

enum (EarthEngineAssetView)

Chỉ định những phần của tài nguyên Image sẽ được trả về trong phản hồi. Nếu bạn không đặt giá trị, giá trị mặc định sẽ trả về tất cả các thuộc tính.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Thông báo phản hồi cho EarthEngineService.ListImages.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Trường
images[]

object (Image)

Danh sách hình ảnh khớp với truy vấn.

nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo. Truyền giá trị này trong trường ListImagesRequest.page_token trong lệnh gọi tiếp theo đến phương thức assets.listImages để truy xuất trang kết quả tiếp theo.

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.

Hình ảnh

Thông tin về hình ảnh trên Earth Engine.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
Trường
name

string

Tên của hình ảnh (nếu có). name có định dạng "projects/*/assets/**" (ví dụ: "projects/earthengine-legacy/assets/users//"). Thuộc tính này thường xuất hiện đối với hình ảnh được lưu trữ, nhưng sẽ là chuỗi trống đối với hình ảnh được tính toán.

id

string

Mã nhận dạng của hình ảnh, nếu có. Tương đương với name không có tiền tố "projects/*/assets/" (ví dụ: "users//"). Thuộc tính này thường xuất hiện đối với hình ảnh được lưu trữ, nhưng sẽ là chuỗi trống đối với hình ảnh được tính toán.

updateTime

string (Timestamp format)

Thời gian sửa đổi gần đây nhất của hình ảnh.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

title

string

Tiêu đề của thành phần.

description

string

Nội dung mô tả tài sản.

properties

object (Struct format)

Các thuộc tính khoá/giá trị được liên kết với hình ảnh.

startTime

string (Timestamp format)

Dấu thời gian liên kết với hình ảnh (nếu có), ví dụ: thời gian chụp hình ảnh vệ tinh. Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm bắt đầu khoảng thời gian đó.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Đối với những thành phần tương ứng với một khoảng thời gian, chẳng hạn như giá trị trung bình trong một tháng hoặc một năm, dấu thời gian này tương ứng với thời điểm kết thúc khoảng thời gian đó (không bao gồm).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

geometry

object (Struct format)

Dấu vết không gian được liên kết với hình ảnh (nếu có) dưới dạng đối tượng hình học GeoJSON (xem RFC 7946).

bands[]

object (ImageBand)

Thông tin về dải dữ liệu của hình ảnh.

sizeBytes

string (int64 format)

Kích thước của một thành phần lá (ví dụ: hình ảnh) tính bằng byte. Giá trị này thường khác 0 đối với hình ảnh được lưu trữ và bằng 0 đối với hình ảnh được tính toán.