Method: projects.assets.getPixels

Récupère les pixels d'un composant Image. Cette méthode personnalisée permet à l'appelant de demander une tuile arbitraire de pixels à partir d'une image, en spécifiant éventuellement les bandes et la projection de la carte. Les données masquées ou manquantes seront encodées en tant que zéros.

Les requêtes sont limitées à 48 Mo de données non compressées par requête, calculées comme le produit des dimensions de la requête en pixels, du nombre de bandes d'image demandées et du nombre d'octets par pixel pour chaque bande. Les requêtes sont également limitées à 32 ko de pixels dans chaque dimension et à 1 024 bandes au maximum. Les requêtes qui dépassent ces limites génèrent un code d'erreur 400 (BAD_REQUEST).

Si la requête aboutit, le corps de la réponse contient les données de pixel demandées dans l'encodage spécifié dans le champ fileFormat de la requête.

Requête HTTP

POST https://earthengine.googleapis.com/v1beta/{name=projects/*/assets/**}:getPixels

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom du composant Image à partir duquel obtenir des pixels. name 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 name indiquée :

  • earthengine.assets.get

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Champs
fileFormat

enum (ImageFileFormat)

Format de fichier de sortie dans lequel renvoyer les valeurs de pixel.
grid

object (PixelGrid)

Paramètres décrivant la grille de pixels dans laquelle extraire les données. Par défaut, la grille de pixels native des données est utilisée.
region

object (Struct format)

Si elle est présente, la région de données à renvoyer, spécifiée en tant qu'objet de géométrie GeoJSON (voir RFC 7946). Étant donné que l'image renvoyée est toujours rectangulaire, la boîte englobante de la géométrie donnée dans le système de coordonnées de sortie est effectivement utilisée. Si grid.dimensions est également spécifié, la grille sera finalement redimensionnée à la taille demandée.
bandIds[]

string

Si présent, spécifie un ensemble spécifique de bandes à partir duquel obtenir des pixels. Les bandes sont identifiées par un ID, comme indiqué par le champ id d'un proto ImageBand.
visualizationOptions

object (VisualizationOptions)

Si présent, ensemble d'options de visualisation à appliquer pour produire une visualisation RVB 8 bits des données, au lieu de renvoyer les données brutes.
workloadTag

string

Balise fournie par l'utilisateur pour suivre ce calcul.

Corps de la réponse

Si la requête aboutit, la réponse est une réponse HTTP générique dont le format est défini par la méthode.

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.