Method: projects.assets.listImages

Répertorie les images d'un composant de collection d'images. Cette méthode permet à l'appelant d'appliquer des filtres spatiotemporels et de métadonnées à une collection d'images.

Requête HTTP

GET https://earthengine.googleapis.com/v1alpha/{parent=projects/*/assets/**}:listImages

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de l'élément de collection d'images à afficher. parent 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 parent 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 aucune valeur n'est spécifiée, la taille de page par défaut dépend de EarthEngineAssetView, avec des limites plus élevées pour les vues plus restrictives.
pageToken

string

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

string (Timestamp format)

Si présent, filtre les résultats en fonction de ceux dont le code temporel est au moins égal à cette valeur (inclusive).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Si présent, filtre les résultats en fonction de ceux dont le code temporel est inférieur à cette valeur (exclusif).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
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). L'intersection spatiale est précise à un mètre près.
filter

string

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

enum (EarthEngineAssetView)

Spécifie les parties de la ressource Image à renvoyer dans la réponse. Si cet argument n'est pas défini, toutes les propriétés sont renvoyées par défaut.

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.ListImages.

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

Représentation JSON 
{
  "images": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
Champs
images[]

object (Image)

Liste des images correspondant à la requête.
nextPageToken

string

Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ ListImagesRequest.page_token de l'appel suivant de la méthode assets.listImages 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.

Image

Informations sur une image Earth Engine.

Représentation JSON 
{
  "name": string,
  "id": string,
  "updateTime": string,
  "title": string,
  "description": string,
  "properties": {
    object
  },
  "startTime": string,
  "endTime": string,
  "geometry": {
    object
  },
  "bands": [
    {
      object (ImageBand)
    }
  ],
  "sizeBytes": string
}
Champs
name

string

Nom de l'image, le cas échéant. name est au format "projects/*/assets/**" (par exemple, "projects/earthengine-legacy/assets/users//"). Cette valeur doit généralement être présente pour les images stockées, mais elle sera la chaîne vide pour les images calculées.
id

string

ID de l'image, le cas échéant. Équivaut à name sans le préfixe "projects/*/assets/" (par exemple, "users//"). Cette valeur doit généralement être présente pour les images stockées, mais elle sera la chaîne vide pour les images calculées.
updateTime

string (Timestamp format)

Heure de la dernière modification de l'image.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
title

string

Titre de l'asset.
description

string

Description de l'asset.
properties

object (Struct format)

Propriétés clé/valeur associées à l'image.
startTime

string (Timestamp format)

Code temporel associé à l'image, le cas échéant (par exemple, heure à laquelle une image satellite a été prise). Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, ce code temporel correspond au début de cet intervalle.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Pour les composants qui correspondent à un intervalle de temps, comme les valeurs moyennes sur un mois ou une année, cet horodatage correspond à la fin de cet intervalle (exclusif).

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
geometry

object (Struct format)

L'empreinte spatiale associée à l'image, le cas échéant, sous la forme d'un objet de géométrie GeoJSON (voir RFC 7946).
bands[]

object (ImageBand)

Informations sur les bandes de données de l'image.
sizeBytes

string (int64 format)

Taille d'un élément de feuille (par exemple, une image) en octets. Cette valeur doit généralement être différente de zéro pour les images stockées et zéro pour les images calculées.