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 ويستخدم 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 ويستخدم 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). تكون التقاطعات المكانية دقيقة إلى متر واحد.
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 ويستخدم 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)

الطابع الزمني المرتبط بالصورة، إن توفّر، مثل الوقت الذي تم فيه التقاط صورة من القمر الصناعي بالنسبة إلى مواد العرض التي تتوافق مع فاصل زمني، مثل متوسط القيم على مدار شهر أو عام، يتوافق الطابع الزمني مع بداية هذا الفاصل.

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 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 ويستخدم 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)

حجم مادة عرض ورقة البيانات (مثل صورة) بالبايت ويجب أن يكون هذا الرقم عادةً غير صفري للصور المخزّنة، وصفرًا للصور المحسوبة.