Method: projects.table.export

Stay organized with collections Save and categorize content based on your preferences.

Initiates a batch process that computes a table and writes the result to one of several destinations.

HTTP request

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:export

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is projects/{project-id}.

Authorization requires the following IAM permission on the specified resource project:

  • earthengine.exports.create

Request body

The request body contains data with the following structure:

JSON representation
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
Fields
expression

object (Expression)

An expression that evaluates to the table to compute and export.

description

string

A human-readable name of the task.

selectors[]

string

An explicit list of columns to include in the result.

requestId

string

A unique string used to detect duplicated requests. If more than one request is made by the same user with the same non-empty requestId, only one of those requests may successfully start a long-running operation. requestId may contain the characters a..z, A..Z, 0-9, or '-'. requestId may be at most 60 characters long.

maxErrorMeters

number

The max allowed error in meters when transforming geometry between coordinate systems. If empty, the max error is 1 meter by default.

maxVertices

integer

Max number of uncut vertices per geometry; geometries with more vertices will be cut into pieces smaller than this size.

workloadTag

string

User supplied label to track this computation.

Union field export_options. Options describing where and how to store the results. export_options can be only one of the following:
fileExportOptions

object (TableFileExportOptions)

If specified, configures export as a file.

assetExportOptions

object (TableAssetExportOptions)

If specified, configures export as an Earth Engine asset.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

If specified, configures export as a FeatureView map.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

For more information, see the Authentication Overview.

TableFileExportOptions

Options for exporting tables as files outside Earth Engine.

JSON representation
{
  "fileFormat": enum (TableFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
Fields
fileFormat

enum (TableFileFormat)

The file format in which to export the table(s).

Union field destination. Where to write the results. destination can be only one of the following:
driveDestination

object (DriveDestination)

If specified, configures export to Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

If specified, configures export to Google Cloud Storage.

TableAssetExportOptions

Options for saving tables as Earth Engine assets.

JSON representation
{
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
}
Fields
earthEngineDestination

object (EarthEngineDestination)

If specified, configures export to Earth Engine.

FeatureViewAssetExportOptions

Options for saving tables or FeatureCollections as FeatureView maps.

JSON representation
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
}
Fields
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

The FeatureView ingestion time parameters. These parameters must be specified at ingestion time and cannot be updated on the fly.

featureViewDestination

object (FeatureViewDestination)

If specified, configures export to FeatureViews.

FeatureViewDestination

Configuration for an Earth Engine FeatureView destination.

JSON representation
{
  "name": string,
  "assetVersion": integer
}
Fields
name

string

Required. The FeatureView asset ID. The server generates a map name from the ID.

assetVersion

integer

The FeatureView asset version to create. Used for aliasing versions with assets. If not set, 0 will be used.