Method: projects.assets.listFeatures
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ویژگی های یک دارایی جدول را فهرست می کند. این روش به تماس گیرنده اجازه می دهد تا فیلترهای مکانی-زمانی و ویژگی را روی یک جدول اعمال کند. نتایج به عنوان لیستی از اشیاء ویژگی GeoJSON برگردانده می شوند.
درخواست HTTP
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
asset | string مورد نیاز. نام دارایی جدول برای فهرست. asset از قالب "projects/*/assets/**" است (به عنوان مثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/foo/bar"). همه دارایی های دیگر تحت پروژه "Earthengine-Public" هستند (به عنوان مثال، "projects/earthengine-public/assets/LANDSAT"). مجوز نیاز به مجوز IAM زیر در مورد asset منبع مشخص شده دارد: |
پارامترهای پرس و جو
| پارامترها |
|---|
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" است که آن را به عنوان یک شی GeoJSON FeatureCollection علامت گذاری می کند. |
features[] | object ( Feature ) فهرستی از ویژگی‌های منطبق با پرس و جو، به‌عنوان فهرستی از اشیاء ویژگی GeoJSON (به RFC 7946 مراجعه کنید) که شامل رشته «ویژگی» در فیلدی به نام «نوع»، هندسه در فیلدی به نام «geometry» و ویژگی‌های کلید/مقدار در فیلدی به نام «ویژگی‌ها» است. |
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 .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists features from a specified Earth Engine table asset using the \u003ccode\u003elistFeatures\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of table data by spatiotemporal and property criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eReturns results as a GeoJSON FeatureCollection containing a list of features and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions or OAuth scopes for authorization to access and retrieve data.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.listFeatures\n\nLists the features in a table asset. This method allows the caller to apply spatiotemporal and property filters to a table. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `asset` | `string` Required. The name of the table asset to list. `asset` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `asset`: - `earthengine.assets.get` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer assets than requested. If unspecified, the page size default is 1000 results per page. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ListFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.ListFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `assets.listFeatures` method. |\n| `region` | `string` If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946). |\n| `filter` | `string` If present, specifies additional simple property filters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for EarthEngineService.ListFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1beta/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1beta/Feature)`)` The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string \"Feature\" in a field named \"type\", the geometry in a field named \"geometry\", and key/value properties in a field named \"properties\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ListFeaturesRequest.page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the `assets.listFeatures` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
