إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
Method: projects.table.computeFeatures
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُحسِّب مجموعة من السمات من خلال تطبيق عملية حسابية عشوائية على السمات في جدول واحد أو أكثر. يتم عرض النتائج كقائمة بعناصر ميزة GeoJSON.
طلب HTTP
POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:computeFeatures
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
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"، ما يصنّفه ككائن FeatureCollection في GeoJSON.
|
features[] |
object (Feature)
قائمة العناصر التي تتطابق مع الطلب، كقائمة بكائنات عناصر GeoJSON (راجِع RFC 7946) التي تحتوي على السلسلة "Feature" في حقل باسم "type"، وشكل العنصر في حقل باسم "geometry"، وخصائص المفتاح/القيمة في حقل باسم "properties"
|
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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eComputes features by applying a given computation to features within tables, returning results as GeoJSON feature objects.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eexpression\u003c/code\u003e to define the computation, and allows pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponses are formatted as GeoJSON FeatureCollections, including a list of features and a token for retrieving further pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization necessitates specific OAuth scopes, including \u003ccode\u003eearthengine\u003c/code\u003e, \u003ccode\u003ecloud-platform\u003c/code\u003e, or their read-only counterparts.\u003c/p\u003e\n"],["\u003cp\u003eUsers can tag computations with a custom \u003ccode\u003eworkloadTag\u003c/code\u003e for tracking purposes.\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/v1/{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/v1/Expression) }, \"pageSize\": integer, \"pageToken\": string, \"workloadTag\": string } ``` |\n\n| Fields ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1/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/v1/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/v1/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/v1/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/v1/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)."]]
