Method: projects.assets.listFeatures

    • The listFeatures method allows applying spatiotemporal and property filters to a table asset and returns results as GeoJSON feature objects.

    • The HTTP request uses the GET method and targets a specific asset using a gRPC Transcoding syntax URL.

    • The asset path parameter is required and specifies the name of the table asset to list, requiring appropriate IAM permissions.

    • Optional query parameters include pageSize , pageToken , region for a GeoJSON geometry filter, and filter for additional property filters.

    • The response body is a JSON object containing the list of features, labeled as a "FeatureCollection", and a nextPageToken for pagination.

    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 OAuth 2.0 Overview .
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: