Method: projects.table.computeFeatures
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مجموعه ای از ویژگی ها را با اعمال یک محاسبه دلخواه بر روی ویژگی های یک یا چند جدول محاسبه می کند. نتایج به عنوان لیستی از اشیاء ویژگی GeoJSON برگردانده می شوند.
درخواست HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
project | string شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب projects/{project-id} است. مجوز نیاز به مجوز IAM زیر در project منبع مشخص شده دارد: -
earthengine.computations.create
|
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"expression": {
object (Expression)
},
"pageSize": integer,
"pageToken": string,
"workloadTag": string
} |
| فیلدها |
|---|
expression | object ( Expression ) عبارت برای محاسبه. |
pageSize | integer حداکثر تعداد نتایج در هر صفحه. سرور ممکن است ویژگی های کمتری را نسبت به آنچه درخواست شده است، برگرداند. اگر مشخص نباشد، اندازه صفحه پیش‌فرض 1000 نتیجه در هر صفحه است. |
pageToken | string نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار ComputeFeaturesResponse.next_page_token است که از فراخوانی قبلی به متد table.computeFeatures بازگردانده می شود. |
workloadTag | string برچسب ارائه شده توسط کاربر برای ردیابی این محاسبات. |
بدن پاسخگو
پیام پاسخ برای EarthEngineService.ComputeFeatures.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"type": string,
"features": [
{
object (Feature)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
type | string همیشه حاوی رشته ثابت "FeatureCollection" است که آن را به عنوان یک شی GeoJSON FeatureCollection علامت گذاری می کند. |
features[] | object ( Feature ) فهرستی از ویژگی‌های منطبق با پرس و جو، به‌عنوان فهرستی از اشیاء ویژگی GeoJSON (به RFC 7946 مراجعه کنید) که شامل رشته «ویژگی» در فیلدی به نام «نوع»، هندسه در فیلدی به نام «geometry» و ویژگی‌های کلید/مقدار در فیلدی به نام «ویژگی‌ها» است. |
nextPageToken | string نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت ComputeFeaturesRequest.page_token در فراخوانی بعدی به متد table.computeFeatures ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید. |
محدوده مجوز
به یکی از حوزه های 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-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eComputes a set of features by applying a computation to features in one or more tables, returning results as a list of GeoJSON feature objects.\u003c/p\u003e\n"],["\u003cp\u003eThe computation is defined by an expression provided in the request body, along with optional parameters for pagination and workload tracking.\u003c/p\u003e\n"],["\u003cp\u003eResults are returned as a GeoJSON FeatureCollection, containing a list of features with their geometry and properties.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires appropriate authorization using OAuth scopes for Earth Engine or Google Cloud Platform.\u003c/p\u003e\n"]]],[],null,["# Method: projects.table.computeFeatures\n\nComputes a set of features by applying an arbitrary computation to features in one or more tables. Results are returned as a list of GeoJSON feature objects.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/table:computeFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.computations.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1alpha/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1alpha/Expression)`)` The expression to compute. |\n| `pageSize` | `integer` The maximum number of results per page. The server may return fewer features 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 [ComputeFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.ComputeFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `table.computeFeatures` method. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nResponse message for EarthEngineService.ComputeFeatures.\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/v1alpha/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/v1alpha/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 [ComputeFeaturesRequest.page_token](/earth-engine/reference/rest/v1alpha/projects.table/computeFeatures#body.request_body.FIELDS.page_token) field in the subsequent call to the `table.computeFeatures` 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)."]]
