Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
Method: projects.locations.tables.create
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Crea un ID che può essere utilizzato per visualizzare i dati "tabella".
Questo attributo viene utilizzato in combinazione con GetTableFeatures. Una chiamata a tables.create fornisce un'espressione e alcune opzioni di output. Il risultato di tables.create è un ID che rappresenta una tabella che è il risultato della valutazione dell'espressione e dell'applicazione di queste opzioni. Successivamente, è possibile effettuare chiamate a GetTableFeatures per ottenere i dati della tabella per l'intera tabella risultante. L'ID sarà valido per un periodo moderato (poche ore).
Il caso d'uso più comune per questa coppia di endpoint è fornire un'espressione complessa tramite una richiesta POST a tables.create e poi recuperare la tabella calcolata tramite una richiesta GET a GetTableFeatures. Questa procedura in due parti consente un utilizzo in più situazioni rispetto a ComputeFeatures. In particolare: - il risultato di ComputeFeatures richiede l'impaginazione per ottenere l'intera gamma di funzionalità. Inoltre, vengono restituiti solo i singoli Feature. - ComputeFeatures può essere chiamato solo da un utente autorizzato, utilizzando un token OAuth con ambito corretto. tables.create ha la stessa limitazione, ma GetTableData può essere richiamato con un URL contenente una chiave API, pertanto gli URL che lo richiamano possono essere utilizzati in modo più ampio.
Richiesta HTTP
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/tables
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. L'elemento principale della posizione in cui verrà creata la tabella (ad es. "projects/*").
|
Parametri di query
| Parametri |
workloadTag |
string
Tag fornito dall'utente per monitorare questo calcolo.
|
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Table.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Table appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti 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
Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
