Method: projects.assets.listFeatures

Lists the features in a table asset. This method allows the caller to apply spatiotemporal and property filters to a table. Results are returned as a list of GeoJSON feature objects.

HTTP request

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listFeatures

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the table asset to list. parent is of the format "projects/*/assets/**" (e.g., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). All user-owned assets are under the project "earthengine-legacy" (e.g., "projects/earthengine-legacy/assets/users/foo/bar"). All other assets are under the project "earthengine-public" (e.g., "projects/earthengine-public/assets/LANDSAT").

Authorization requires one or more of the following Google IAM permissions on the specified resource parent:

  • earthengine.assets.get
  • earthengine.computations.create

Query parameters

Parameters
pageSize

number

An optional maximum number of results per page. The server may return fewer assets than requested. If unspecified, server will pick an appropriate default.

pageToken

string

An optional token identifying a page of results the server should return. Typically, this is the value of ListFeaturesResponse.next_page_token returned from the previous call to the assets.listFeatures method.

region

string

If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946).

filter

string

If present, specifies additional simple property filters.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for EarthEngineService.ListFeatures.

JSON representation
{
  "type": string,
  "features": [
    {
      object (Feature)
    }
  ],
  "nextPageToken": string
}
Fields
type

string

Always contains the constant string "FeatureCollection", marking this as a GeoJSON FeatureCollection object.

features[]

object (Feature)

The list of features matching the query, as a list of GeoJSON feature objects (see RFC 7946) containing the string "Feature" in a field named "type", the geometry in a field named "geometry", and key/value properties in a field named "properties".

nextPageToken

string

A token to retrieve the next page of results. Pass this value in the ListFeaturesRequest.page_token field in the subsequent call to the assets.listFeatures method to retrieve the next page of results.

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