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/v1/{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 unique ID representing a table derived from a given 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, facilitating complex data fetching scenarios.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003etables.create\u003c/code\u003e and \u003ccode\u003eGetTableFeatures\u003c/code\u003e together offers advantages over \u003ccode\u003eComputeFeatures\u003c/code\u003e, such as bypassing pagination and broader sharing capabilities with API keys.\u003c/p\u003e\n"],["\u003cp\u003eThis two-step process enables complex expression evaluation via a POST request to \u003ccode\u003etables.create\u003c/code\u003e, followed by data retrieval using a GET request to \u003ccode\u003eGetTableFeatures\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required for \u003ccode\u003etables.create\u003c/code\u003e but \u003ccode\u003eGetTableFeatures\u003c/code\u003e can be accessed with an API key for wider usage.\u003c/p\u003e\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/v1/{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/v1/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/v1/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)."]]
