Method: projects.assets.getPixels

Recupera i pixel da un asset immagine. Questo metodo personalizzato consente all'utente chiamante di richiedere un riquadro arbitrario di pixel da un'immagine, specificando facoltativamente le bande e la proiezione della mappa. I dati mascherati o mancanti verranno codificati come zeri.

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/v1/{name=projects/*/assets/**}:getPixels

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome dell'asset immagine da cui ottenere i pixel. name sia nel formato "projects/*/assets/**" (ad es. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Tutti gli asset di proprietà dell'utente si trovano nel progetto "earthengine-legacy" (ad es. "projects/earthengine-legacy/assets/users/foo/bar"). Tutti gli altri asset si trovano nel progetto "earthengine-public" (ad es. "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

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

enum (ImageFileFormat)

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

object (PixelGrid)

Parametri che descrivono la griglia di pixel in cui recuperare i dati. Il valore predefinito è la griglia di pixel nativa dei dati.
region

object (Struct format)

Se presente, la regione di dati da restituire, specificata come oggetto geometria GeoJSON (vedi RFC 7946). Poiché l'immagine restituita è sempre rettangolare, verrà effettivamente utilizzata la scatola delimitante della geometria specificata nel sistema di coordinate di output. Se viene specificato anche grid.dimensions, la griglia verrà infine riscalata alle dimensioni richieste.
bandIds[]

string

Se presente, specifica un insieme specifico di bande da cui ottenere i pixel. Le bande sono identificate dall'ID, come indicato dal campo id di un proto ImageBand.
visualizationOptions

object (VisualizationOptions)

Se presente, un insieme di opzioni di visualizzazione da applicare per produrre una visualizzazione RGB a 8 bit dei dati anziché restituire i dati non elaborati.
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.