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/v1beta/{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 Authentication Overview.