Method: projects.assets.getPixels

Recupera píxeles de un recurso de imagen. Este método personalizado permite que el llamador solicite una tarjeta arbitraria de píxeles de una imagen, de manera opcional, especificando las bandas y la proyección del mapa. Los datos enmascarados o faltantes se codificarán como ceros.

Las solicitudes se limitan a 48 MB de datos sin comprimir por solicitud, que se calculan como el producto de las dimensiones de la solicitud en píxeles, la cantidad de bandas de imágenes solicitadas y la cantidad de bytes por píxel de cada banda. Las solicitudes también se limitan a un máximo de 32,000 píxeles en cualquier dimensión y 1,024 bandas como máximo. Las solicitudes que superen estos límites generarán un código de error 400 (BAD_REQUEST).

Si se realiza correctamente, el cuerpo de la respuesta contendrá los datos de píxeles solicitados en la codificación especificada en el campo fileFormat de la solicitud.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Es obligatorio. Es el nombre del recurso de imagen del que se deben obtener los píxeles. name tiene el formato "projects/*/assets/**" (p.ej., "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Todos los recursos que pertenecen al usuario están en el proyecto "earthengine-legacy" (p.ej., "projects/earthengine-legacy/assets/users/foo/bar"). Todos los demás recursos se encuentran en el proyecto "earthengine-public" (p.ej., "projects/earthengine-public/assets/LANDSAT").

La autorización requiere el siguiente permiso IAM en el recurso especificado name:

  • earthengine.assets.get

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Campos
fileFormat

enum (ImageFileFormat)

Es el formato de archivo de salida en el que se muestran los valores de píxeles.
grid

object (PixelGrid)

Parámetros que describen la cuadrícula de píxeles en la que se deben recuperar los datos. El valor predeterminado es la cuadrícula de píxeles nativa de los datos.
region

object (Struct format)

Si está presente, es la región de datos que se mostrará, especificada como un objeto de geometría GeoJSON (consulta RFC 7946). Dado que la imagen que se muestra siempre es rectangular, se usará el cuadro delimitador de la geometría determinada en el sistema de coordenadas de salida. Si también se especifica grid.dimensions, la cuadrícula se volverá a escalar al tamaño solicitado.
bandIds[]

string

Si está presente, especifica un conjunto específico de bandas de las que se deben obtener píxeles. Las bandas se identifican por ID, como se indica en el campo id de un proto de ImageBand.
visualizationOptions

object (VisualizationOptions)

Si está presente, es un conjunto de opciones de visualización que se aplican para producir una visualización RGB de 8 bits de los datos, en lugar de mostrar los datos sin procesar.
workloadTag

string

Es la etiqueta que proporcionó el usuario para hacer un seguimiento de este cálculo.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, la respuesta es una respuesta HTTP genérica, y el método define su formato.

Permisos de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta OAuth 2.0 Overview.