Method: projects.assets.listImages

แสดงรายการรูปภาพในชิ้นงานคอลเล็กชันรูปภาพ วิธีนี้ช่วยให้ผู้เรียกใช้ใช้ตัวกรองเชิงพื้นที่และเวลา รวมถึงตัวกรองข้อมูลเมตากับคอลเล็กชันรูปภาพได้

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ ชื่อของชิ้นงานคอลเล็กชันรูปภาพที่จะแสดง parent อยู่ในรูปแบบ "projects/*/assets/**" (เช่น "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). ชิ้นงานทั้งหมดที่ผู้ใช้เป็นเจ้าของจะอยู่ในโปรเจ็กต์ "earthengine-legacy" (เช่น "projects/earthengine-legacy/assets/users/foo/bar"). ชิ้นงานอื่นๆ ทั้งหมดจะอยู่ภายใต้โปรเจ็กต์ "earthengine-public" (เช่น "projects/earthengine-public/assets/LANDSAT").

การให้สิทธิ์ต้องใช้สิทธิ์ IAM ต่อไปนี้ในทรัพยากร parent ที่ระบุ

  • earthengine.assets.get

พารามิเตอร์การค้นหา

พารามิเตอร์
pageSize

integer

จำนวนผลลัพธ์สูงสุดต่อหน้า เซิร์ฟเวอร์อาจแสดงผลชิ้นงานน้อยกว่าที่ขอ หากไม่ได้ระบุ ค่าเริ่มต้นของขนาดหน้าเว็บจะขึ้นอยู่กับ EarthEngineAssetView โดยจะมีขีดจำกัดที่สูงขึ้นสำหรับมุมมองที่จำกัดมากขึ้น
pageToken

string

โทเค็นที่ระบุหน้าผลการค้นหาที่เซิร์ฟเวอร์ควรแสดง โดยปกติแล้ว ค่านี้คือค่าของ ListImagesResponse.next_page_token ที่แสดงผลจากการเรียกใช้เมธอด assets.listImages ก่อนหน้านี้
startTime

string (Timestamp format)

หากมี จะกรองผลลัพธ์เป็นรายการที่มีการประทับเวลาอย่างน้อยเท่ากับค่านี้ (รวม)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

หากมี จะกรองผลลัพธ์ที่การประทับเวลาน้อยกว่าค่านี้ (ไม่รวม)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
region

string

รูปทรงเรขาคณิตที่กําหนดขอบเขตการค้นหา (หากมี) ซึ่งระบุเป็นสตริงรูปทรงเรขาคณิต GeoJSON (ดู RFC 7946) การซ้อนทับเชิงพื้นที่มีความแม่นยำถึง 1 เมตร
filter

string

(หากมี) ระบุตัวกรองพร็อพเพอร์ตี้แบบง่ายเพิ่มเติม
view

enum (EarthEngineAssetView)

ระบุส่วนของแหล่งข้อมูล Image ที่ควรแสดงในการตอบกลับ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะแสดงพร็อพเพอร์ตี้ทั้งหมด

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสําหรับ EarthEngineService.ListImages

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
ช่อง
images[]

object (Image)

รายการรูปภาพที่ตรงกับการค้นหา
nextPageToken

string

โทเค็นสําหรับดึงข้อมูลหน้าถัดไปของผลการค้นหา ส่งค่านี้ในช่อง ListImagesRequest.page_token ในการเรียกใช้เมธอด assets.listImages ครั้งถัดไปเพื่อดึงข้อมูลหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • 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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

รูปภาพ

ข้อมูลเกี่ยวกับรูปภาพ Earth Engine

การแสดง JSON 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
ช่อง
name

string

ชื่อรูปภาพ (หากมี) name อยู่ในรูปแบบ "projects/*/assets/**" (เช่น "projects/earthengine-legacy/assets/users//") โดยปกติแล้วค่านี้ควรมีอยู่ในรูปภาพที่จัดเก็บไว้ แต่จะเป็นสตริงว่างสำหรับรูปภาพที่คำนวณแล้ว
id

string

รหัสของรูปภาพ (หากมี) เทียบเท่ากับ name ที่ไม่มีคํานำหน้า "projects/*/assets/" (เช่น "users//") โดยปกติแล้วค่านี้ควรมีอยู่ในรูปภาพที่จัดเก็บไว้ แต่จะเป็นสตริงว่างสำหรับรูปภาพที่คำนวณแล้ว
updateTime

string (Timestamp format)

เวลาที่แก้ไขรูปภาพล่าสุด

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
title

string

ชื่อเนื้อหา
description

string

คำอธิบายของเนื้อหา
properties

object (Struct format)

พร็อพเพอร์ตี้คีย์/ค่าที่เชื่อมโยงกับรูปภาพ
startTime

string (Timestamp format)

การประทับเวลาที่เชื่อมโยงกับรูปภาพ หากมี เช่น เวลาถ่ายภาพจากดาวเทียม สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงเริ่มต้นของช่วงเวลานั้น

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
endTime

string (Timestamp format)

สําหรับเนื้อหาที่สอดคล้องกับช่วงเวลา เช่น ค่าเฉลี่ยในช่วง 1 เดือนหรือ 1 ปี การประทับเวลานี้จะสอดคล้องกับช่วงสิ้นสุดของช่วงเวลานั้น (ไม่รวม)

ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 0, 3, 6 หรือ 9 ระบบยังยอมรับออฟเซตอื่นๆ นอกเหนือจาก "Z" ด้วย ตัวอย่างเช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
geometry

object (Struct format)

ร่องรอยเชิงพื้นที่ที่เชื่อมโยงกับรูปภาพ (หากมี) เป็นออบเจ็กต์เรขาคณิต GeoJSON (ดู RFC 7946)
bands[]

object (ImageBand)

ข้อมูลเกี่ยวกับย่านความถี่ของข้อมูลรูปภาพ
sizeBytes

string (int64 format)

ขนาดของชิ้นงานระดับล่าง (เช่น รูปภาพ) เป็นไบต์ โดยปกติแล้วค่านี้ไม่ควรเป็น 0 สำหรับรูปภาพที่จัดเก็บไว้ และควรเป็น 0 สำหรับรูปภาพที่คำนวณ