Method: projects.locations.tables.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt eine ID, mit der Tabellendaten gerendert werden können.
Dies wird in Verbindung mit GetTableFeatures verwendet. Ein Aufruf von tables.create liefert einen Ausdruck und einige Ausgabeoptionen. Das Ergebnis von tables.create ist eine ID, die eine Tabelle darstellt, die durch die Auswertung dieses Ausdrucks und das Anwenden dieser Optionen entstanden ist. Anschließend können Aufrufe von GetTableFeatures erfolgen, um die Tabellendaten für die gesamte resultierende Tabelle abzurufen. Die ID ist für einen begrenzten Zeitraum (einige Stunden) gültig.
Der häufigste Anwendungsfall für dieses Endpunktpaar besteht darin, einen komplexen Ausdruck über eine POST-Anfrage an tables.create zu senden und dann die berechnete Tabelle über eine GET-Anfrage an GetTableFeatures abzurufen. Dieser zweiteilige Prozess kann in mehr Situationen als ComputeFeatures verwendet werden. Insbesondere: Für das Ergebnis von ComputeFeatures ist eine Paginierung erforderlich, um alle Funktionen nutzen zu können. Außerdem werden nur einzelne Feature zurückgegeben. – ComputeFeatures kann nur von einem autorisierten Nutzer mit einem OAuth-Token mit korrektem Gültigkeitsbereich aufgerufen werden. tables.create unterliegt derselben Einschränkung, GetTableData kann jedoch mit einer URL aufgerufen werden, die einen API-Schlüssel enthält. Daher können URLs, die GetTableData aufrufen, breiter verwendet werden.
HTTP-Anfrage
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/tables
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Das übergeordnete Element des Speicherorts, an dem die Tabelle erstellt wird (z.B. „projects/*“).
|
Abfrageparameter
| Parameter |
workloadTag |
string
Vom Nutzer bereitgestelltes Tag zum Erfassen dieser Berechnung.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Table.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Table.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
