Method: projects.assets.getPixels

Mengambil piksel dari aset gambar. Metode kustom ini memungkinkan pemanggil meminta ubin piksel arbitrer dari gambar, secara opsional menentukan band dan proyeksi peta. Data yang disamarkan atau tidak ada akan dienkode sebagai nol.

Permintaan dibatasi hingga 48 MB dalam data yang tidak dikompresi per permintaan, yang dihitung sebagai produk dimensi permintaan dalam piksel, jumlah band gambar yang diminta, dan jumlah byte per piksel untuk setiap band. Permintaan juga dibatasi maksimal 32K piksel di salah satu dimensi dan maksimal 1024 band. Permintaan yang melebihi batas ini akan menghasilkan kode error 400 (BAD_REQUEST).

Jika berhasil, isi respons akan berisi data piksel yang diminta dalam encoding yang ditentukan di kolom fileFormat permintaan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Wajib. Nama aset gambar tempat mendapatkan piksel. name memiliki format "projects/*/assets/**" (misalnya, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Semua aset milik pengguna berada dalam project "earthengine-legacy" (mis., "projects/earthengine-legacy/assets/users/foo/bar"). Semua aset lainnya berada dalam project "earthengine-public" (misalnya, "projects/earthengine-public/assets/LANDSAT").

Otorisasi memerlukan izin IAM berikut pada resource name yang ditentukan:

  • earthengine.assets.get

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

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

enum (ImageFileFormat)

Format file output tempat menampilkan nilai piksel.
grid

object (PixelGrid)

Parameter yang menjelaskan petak piksel tempat mengambil data. Setelan default-nya adalah petak piksel native data.
region

object (Struct format)

Jika ada, wilayah data yang akan ditampilkan, yang ditentukan sebagai objek geometri GeoJSON (lihat RFC 7946). Karena gambar yang ditampilkan selalu berbentuk persegi panjang, kotak pembatas geometri tertentu dalam sistem koordinat output akan benar-benar digunakan. Jika grid.dimensions juga ditentukan, petak akhirnya akan diskalakan ulang ke ukuran yang diminta.
bandIds[]

string

Jika ada, menentukan kumpulan band tertentu tempat piksel akan diambil. Band diidentifikasi dengan ID, seperti yang ditunjukkan oleh kolom id dari proto ImageBand.
visualizationOptions

object (VisualizationOptions)

Jika ada, kumpulan opsi visualisasi yang akan diterapkan untuk menghasilkan visualisasi RGB 8-bit dari data, bukan menampilkan data mentah.
workloadTag

string

Tag yang diberikan pengguna untuk melacak komputasi ini.

Isi respons

Jika berhasil, responsnya adalah respons HTTP generik yang formatnya ditentukan oleh metode.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.