Method: projects.assets.listFeatures

يسرد العناصر في مادة عرض جدول. تسمح هذه الطريقة للمُتصل بتطبيق فلاتر الموقع الجغرافي والوقت والموقع على جدول. يتم عرض النتائج كقائمة بعناصر ميزة GeoJSON.

طلب HTTP

GET https://earthengine.googleapis.com/v1alpha/{asset=projects/*/assets/**}:listFeatures

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
asset

string

مطلوب. اسم مادة عرض الجدول المطلوب إدراجها. يكون asset بالتنسيق "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 التالي على المورد المحدّد asset:

  • earthengine.assets.get

مَعلمات طلب البحث

المعلمات
pageSize

integer

الحد الأقصى لعدد النتائج في كل صفحة قد يعرض الخادم عددًا أقل من مواد العرض المطلوبة. إذا لم يتم تحديد حجم الصفحة، يكون الحجم التلقائي للصفحة هو 1000 نتيجة في الصفحة.
pageToken

string

رمز مميّز يحدِّد صفحة من النتائج التي يجب أن يعرضها الخادم. وعادةً ما تكون هذه هي قيمة ListFeaturesResponse.next_page_token التي تم إرجاعها من الطلب السابق إلى طريقة assets.listFeatures.
region

string

شكل هندسي يحدِّد منطقة طلب بحث، إذا كان متوفّرًا، ويتم تحديده على أنّه سلسلة شكل هندسي GeoJSON (راجِع RFC 7946).
filter

string

في حال توفّرها، تحدِّد فلاتر مواقع بسيطة إضافية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

رسالة الردّ لـ EarthEngineService.ListFeatures

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "type": string,
  "features": [
    {
      object (Feature)
    }
  ],
  "nextPageToken": string
}
الحقول
type

string

يحتوي دائمًا على السلسلة الثابتة "FeatureCollection"، ما يصنّفه ككائن FeatureCollection في GeoJSON.
features[]

object (Feature)

قائمة العناصر التي تتطابق مع الطلب، كقائمة بكائنات عناصر GeoJSON (راجِع RFC 7946) التي تحتوي على السلسلة "Feature" في حقل باسم "type"، وشكل العنصر في حقل باسم "geometry"، وخصائص المفتاح/القيمة في حقل باسم "properties"
nextPageToken

string

رمز مميّز لاسترداد الصفحة التالية من النتائج نقْل هذه القيمة في حقل ListFeaturesRequest.page_token في الطلب اللاحق لطريقة assets.listFeatures لاسترداد الصفحة التالية من النتائج.

نطاقات التفويض

يتطلب أحد نطاقات 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.