Method: projects.image.computePixels

Calcola un riquadro di pixel eseguendo un calcolo arbitrario sui dati dell'immagine.

Le richieste sono limitate a 48 MB di dati non compressi per richiesta, calcolati come prodotto delle dimensioni della richiesta in pixel, del numero di bande di immagini richieste e del numero di byte per pixel per ogni banda. Le richieste sono inoltre limitate a un massimo di 32.000 pixel in entrambe le dimensioni e a un massimo di 1024 bande. Le richieste che superano questi limiti restituiranno un codice di errore 400 (BAD_REQUEST).

In caso di esito positivo, il corpo della risposta contiene i dati dei pixel richiesti nella codifica specificata nel campo fileFormat della richiesta.

Richiesta HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:computePixels

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
project

string

L'ID o il numero del progetto della piattaforma Google Cloud che deve essere considerato il consumatore di servizi per questa richiesta. Il formato è projects/{project-id}.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata project:

  • earthengine.computations.create

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "expression": {
    object (Expression)
  },
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Campi
expression

object (Expression)

L'espressione da calcolare.

fileFormat

enum (ImageFileFormat)

Il formato file di output in cui restituire i valori dei pixel.

grid

object (PixelGrid)

Parametri che descrivono come l'immagine calcolata da expression deve essere riproiettata e ritagliata. Se non è presente, l'immagine completa calcolata viene restituita nella sua proiezione nativa.

bandIds[]

string

Se presente, specifica un insieme specifico di bande che verranno selezionate dal risultato della valutazione di expression. Se non è presente, verranno selezionate tutte le bande risultanti da expression.

visualizationOptions

object (VisualizationOptions)

Se presente, un insieme di opzioni di visualizzazione da applicare per produrre una visualizzazione RGB a 8 bit dei dati.

workloadTag

string

Tag fornito dall'utente per monitorare questo calcolo.

Corpo della risposta

In caso di esito positivo, la risposta è una risposta HTTP generica il cui formato è definito dal metodo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • 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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.