Method: projects.locations.tables.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת מזהה שאפשר להשתמש בו כדי להציג נתוני 'טבלה'.
משתמשים בו בשילוב עם GetTableFeatures. קריאה ל-tables.create מספקת ביטוי וכמה אפשרויות פלט. התוצאה של tables.create היא מזהה שמייצג טבלה שהיא תוצאת הערכת הביטוי הזה והחלה של האפשרויות האלה. לאחר מכן, אפשר לבצע קריאות ל-GetTableFeatures כדי לקבל את נתוני הטבלה של כל הטבלה שנוצרה. התעודה המזהה תהיה תקפה למשך פרק זמן קצר (כמה שעות).
התרחיש לדוגמה הנפוץ ביותר לשימוש בשני נקודות הקצה האלה הוא לספק ביטוי מורכב באמצעות POST אל tables.create, ולאחר מכן לאחזר את הטבלה המחושבת באמצעות GET אל GetTableFeatures. התהליך הזה, שמורכב משני חלקים, מאפשר שימוש במצבים רבים יותר מאשר ComputeFeatures. באופן ספציפי: - התוצאה של ComputeFeatures דורשת חלוקה לדפים כדי לקבל את כל התכונות. בנוסף, המערכת מחזירה רק ערכים ספציפיים של Feature. - רק משתמש מורשה יכול להפעיל את ComputeFeatures באמצעות אסימון OAuth ברמת היקף מתאימה. ל-tables.create יש את אותה הגבלה, אבל אפשר להפעיל את GetTableData באמצעות כתובת URL שמכילה מפתח API, כך שאפשר להשתמש בכתובות URL שמפעילות אותו באופן רחב יותר.
בקשת HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/tables
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
parent |
string
חובה. ההורה של המיקום שבו הטבלה תיווצר (למשל, "projects/*").
|
פרמטרים של שאילתה
| פרמטרים |
workloadTag |
string
תג שהמשתמש סיפק כדי לעקוב אחרי החישוב הזה.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Table.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Table.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eThe \u003ccode\u003etables.create\u003c/code\u003e endpoint generates a temporary ID representing a table derived from a provided expression and output options.\u003c/p\u003e\n"],["\u003cp\u003eThis ID can then be used with \u003ccode\u003eGetTableFeatures\u003c/code\u003e to retrieve the entire table data, enabling complex expressions and broader access via API keys.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etables.create\u003c/code\u003e offers advantages over \u003ccode\u003eComputeFeatures\u003c/code\u003e by avoiding pagination for complete results and allowing data access with API keys in \u003ccode\u003eGetTableFeatures\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required for \u003ccode\u003etables.create\u003c/code\u003e, using OAuth scopes similar to \u003ccode\u003eComputeFeatures\u003c/code\u003e, but \u003ccode\u003eGetTableFeatures\u003c/code\u003e allows access via URLs containing API keys for wider usage.\u003c/p\u003e\n"]]],["`tables.create` generates an ID representing a table from an expression and output options. `GetTableFeatures` then retrieves the table data using this ID. This method is advantageous over `ComputeFeatures` because it allows full table retrieval without pagination and can be accessed via an API key. The process involves a POST request to `tables.create`, providing the expression. The ID is valid for a limited duration, and an authorized user or a public API key is needed to make calls to `GetTableFeatures`.\n"],null,["# Method: projects.locations.tables.create\n\nCreates an ID that can be used to render \"table\" data.\n\nThis is used in conjunction with `GetTableFeatures`. A call to `tables.create` provides an expression and some output options. The result of `tables.create` is an ID that represents a table that is the result of evaluating that expression and applying those options. Subsequently, calls to `GetTableFeatures` can be made to get the table data for the entire resulting table. The ID will be valid for a moderate period (a few hours).\n\nThe most common use case for this pair of endpoints is to provide a complex expression via a POST to `tables.create`, and then fetch the computed table via a GET to `GetTableFeatures`. This two-part process allows for use in more situations than `ComputeFeatures`. In particular: - the result of `ComputeFeatures` requires pagination to get the entirety of the features. Additionally only individual `Feature`s are returned. - `ComputeFeatures` can only be called by an authorized user, using a properly-scoped OAuth token. `tables.create` has the same restriction, but `GetTableData` can be invoked with a URL containing an API key, so URLs invoking it can be used more broadly.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/tables`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the location where the table will be created (e.g., \"projects/\\*\"). |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------|\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Request body\n\nThe request body contains an instance of [Table](/earth-engine/reference/rest/v1beta/projects.locations.tables#Table).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Table](/earth-engine/reference/rest/v1beta/projects.locations.tables#Table).\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)."]]
