AI-generated Key Takeaways
-
The
listFeaturesmethod allows applying spatiotemporal and property filters to a table asset. -
Results of the
listFeaturesmethod 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
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
|
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
|
A token identifying a page of results the server should return. Typically, this is the value of |
region
|
If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946). |
filter
|
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 (
|
| Fields | |
|---|---|
type
|
Always contains the constant string "FeatureCollection", marking this as a GeoJSON FeatureCollection object. |
features[]
|
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
|
A token to retrieve the next page of results. Pass this value in the |
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 .

