Method: projects.tables.create

  • The tables.create method generates an ID representing a table based on an expression and output options, intended for use with tables.getFeatures to retrieve the table data.

  • This two-part process of creating an ID and then fetching data is more flexible than ComputeFeatures, particularly in terms of data retrieval and broader access using an API key.

  • The HTTP request to create a table is a POST to https://earthengine.googleapis.com/v1beta/{parent=projects/*}/tables, requiring a parent project and an optional workload tag in the query parameters.

  • The request body should contain a Table instance, and a successful response will return a newly created Table instance.

  • Authorization requires one of the specified OAuth scopes.

Creates an ID that can be used to render "table" data.

This is used in conjunction with tables.getFeatures. 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 tables.getFeatures 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).

The 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 tables.getFeatures. 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 Features 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.

HTTP request

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*}/tables

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent of the location where the table will be created (e.g., "projects/*").

Query parameters

Parameters
workloadTag

string

User supplied tag to track this computation.

Request body

The request body contains an instance of Table.

Response body

If successful, the response body contains a newly created instance of Table.

Authorization scopes

Requires one of the following OAuth scopes:

  • 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

For more information, see the OAuth 2.0 Overview.