Method: projects.assets.listImages

تصاویر موجود در یک مجموعه تصویر را فهرست می‌کند. این متد به فراخوانی‌کننده اجازه می‌دهد تا فیلترهای مکانی-زمانی و فراداده‌ای را بر روی یک مجموعه تصویر اعمال کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

region

string

در صورت وجود، هندسه‌ای که یک منطقه پرس‌وجو را تعریف می‌کند، به عنوان یک رشته هندسی GeoJSON مشخص شده است (به RFC 7946 مراجعه کنید). تقاطع مکانی با دقت یک متر انجام می‌شود.

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 .

تصویر

اطلاعات مربوط به تصویر موتور زمینی.

نمایش 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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

مهر زمانی مرتبط با تصویر، در صورت وجود، مثلاً زمانی که تصویر ماهواره‌ای گرفته شده است. برای داده‌هایی که مربوط به یک بازه زمانی هستند، مانند مقادیر میانگین در طول یک ماه یا سال، این مهر زمانی مربوط به شروع آن بازه زمانی است.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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)

اندازه یک عنصر برگ (مثلاً یک تصویر) بر حسب بایت. این مقدار معمولاً برای تصاویر ذخیره شده باید غیر صفر و برای تصاویر محاسبه شده صفر باشد.