Method: projects.assets.listFeatures

  • The listFeatures method allows applying spatiotemporal and property filters to a table asset.

  • Results of the listFeatures method are returned as a list of GeoJSON feature objects.

  • The HTTP request to list features uses a GET method with a specific URL structure including the asset name.

  • Path parameters include the required asset name, formatted as "projects/*/assets/**".

  • Query parameters allow specifying page size, a page token for pagination, a GeoJSON region, and property filters.

  • The response body contains a GeoJSON FeatureCollection object with a list of matching features and a token for the next page of results.

  • Authorization requires specific IAM permissions on the specified asset resource and OAuth scopes.

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/{asset=projects/*/assets/**}:listFeatures

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
asset

string

Required. The name of the table asset to list. asset 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 the following IAM permission on the specified resource asset:

  • earthengine.assets.get

Query parameters

Parameters
pageSize

integer

The maximum number of results per page. The server may return fewer assets than requested. If unspecified, the page size default is 1000 results per page.
pageToken

string

A 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

Response message for EarthEngineService.ListFeatures.

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

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

For more information, see the OAuth 2.0 Overview.