Method: projects.assets.listFeatures
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hier werden die Elemente in einem Tabellen-Asset aufgelistet. Mit dieser Methode kann der Aufrufer raumzeitliche und Property-Filter auf eine Tabelle anwenden. Die Ergebnisse werden als Liste von GeoJSON-Elementobjekten zurückgegeben.
HTTP-Anfrage
GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
asset |
string
Erforderlich. Der Name des zu listenden Tabellen-Assets. asset hat das Format „projects/*/assets/**“ (z.B. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Alle vom Nutzer erstellten Assets befinden sich im Projekt „earthengine-legacy“ (z.B. "projects/earthengine-legacy/assets/users/foo/bar"). Alle anderen Assets befinden sich im Projekt „earthengine-public“ (z.B. "projects/earthengine-public/assets/LANDSAT").
Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource asset erforderlich:
|
Suchparameter
| Parameter |
pageSize |
integer
Die maximale Anzahl von Ergebnissen pro Seite. Der Server gibt möglicherweise weniger Assets zurück, als angefordert. Wenn keine Seitengröße angegeben wird, ist die Standardseitengröße 1.000 Ergebnisse pro Seite.
|
pageToken |
string
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Normalerweise ist dies der Wert von ListFeaturesResponse.next_page_token, der vom vorherigen Aufruf der assets.listFeatures-Methode zurückgegeben wurde.
|
region |
string
Falls vorhanden, eine Geometrie, die eine Abfrageregion definiert, angegeben als GeoJSON-Geometriestring (siehe RFC 7946).
|
filter |
string
Gibt gegebenenfalls zusätzliche einfache Property-Filter an.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für EarthEngineService.ListFeatures
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"type": string,
"features": [
{
object (Feature)
}
],
"nextPageToken": string
} |
| Felder |
type |
string
Enthält immer den konstanten String „FeatureCollection“, was es als GeoJSON-FeatureCollection-Objekt kennzeichnet.
|
features[] |
object (Feature)
Die Liste der Features, die der Abfrage entsprechen, als Liste von GeoJSON-Feature-Objekten (siehe RFC 7946) mit dem String „Feature“ in einem Feld namens „type“, der Geometrie in einem Feld namens „geometry“ und Schlüssel/Wert-Attributen in einem Feld namens „properties“.
|
nextPageToken |
string
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im Feld ListFeaturesRequest.page_token im nachfolgenden Aufruf der Methode assets.listFeatures, um die nächste Ergebnisseite abzurufen.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Weitere Informationen finden Sie unter OAuth 2.0 Overview.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eLists features from a specified Earth Engine table asset using the \u003ccode\u003elistFeatures\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of table data by spatiotemporal and property criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eReturns results as a GeoJSON FeatureCollection containing a list of features and a token for pagination.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permissions or OAuth scopes for authorization to access and retrieve data.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.listFeatures\n\nLists 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.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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](https://cloud.google.com/iam/docs/) permission on the specified resource `asset`: - `earthengine.assets.get` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [ListFeaturesResponse.next_page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.ListFeaturesResponse.FIELDS.next_page_token) returned from the previous call to the `assets.listFeatures` method. |\n| `region` | `string` If present, a geometry defining a query region, specified as a GeoJSON geometry string (see RFC 7946). |\n| `filter` | `string` If present, specifies additional simple property filters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for EarthEngineService.ListFeatures.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"type\": string, \"features\": [ { object (/earth-engine/reference/rest/v1beta/Feature) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `type` | `string` Always contains the constant string \"FeatureCollection\", marking this as a GeoJSON FeatureCollection object. |\n| `features[]` | `object (`[Feature](/earth-engine/reference/rest/v1beta/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\". |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ListFeaturesRequest.page_token](/earth-engine/reference/rest/v1beta/projects.assets/listFeatures#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the `assets.listFeatures` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
