Method: projects.assets.listFeatures

Répertorie les éléments d'un élément de table. Cette méthode permet à l'appelant d'appliquer des filtres spatiotemporels et de propriété à une table. Les résultats sont renvoyés sous la forme d'une liste d'objets d'éléments géographiques GeoJSON.

Requête HTTP

GET https://earthengine.googleapis.com/v1beta/{asset=projects/*/assets/**}:listFeatures

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
asset

string

Obligatoire. Nom de l'élément de table à lister. asset est au format "projects/*/assets/**" (par exemple, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tous les composants appartenant à l'utilisateur sont inclus dans le projet "earthengine-legacy" (par exemple, "projects/earthengine-legacy/assets/users/foo/bar"). Tous les autres composants sont associés au projet "earthengine-public" (par exemple, "projects/earthengine-public/assets/LANDSAT").

L'autorisation IAM suivante est requise pour la ressource asset indiquée :

  • earthengine.assets.get

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de résultats par page. Le serveur peut renvoyer moins d'assets que demandé. Si cette option n'est pas spécifiée, la taille de page par défaut est de 1 000 résultats par page.
pageToken

string

Jeton identifiant une page de résultats que le serveur doit renvoyer. Il s'agit généralement de la valeur de ListFeaturesResponse.next_page_token renvoyée par l'appel précédent à la méthode assets.listFeatures.
region

string

Si elle est présente, une géométrie définissant une région de requête, spécifiée sous la forme d'une chaîne de géométrie GeoJSON (voir RFC 7946).
filter

string

Le cas échéant, spécifie d'autres filtres de propriété simples.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour EarthEngineService.ListFeatures.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "type": string,
  "features": [
    {
      object (Feature)
    }
  ],
  "nextPageToken": string
}
Champs
type

string

Contient toujours la chaîne constante "FeatureCollection", ce qui le marque comme un objet FeatureCollection GeoJSON.
features[]

object (Feature)

Liste des éléments géographiques correspondant à la requête, sous la forme d'une liste d'objets géographiques GeoJSON (voir RFC 7946) contenant la chaîne "Feature" dans un champ nommé "type", la géométrie dans un champ nommé "geometry" et les propriétés clé/valeur dans un champ nommé "properties".
nextPageToken

string

Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ ListFeaturesRequest.page_token de l'appel suivant de la méthode assets.listFeatures pour récupérer la page de résultats suivante.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez OAuth 2.0 Overview.