Method: projects.assets.getPixels

Bir resim öğesinden piksel getirir. Bu özel yöntem, arayanın isteğe bağlı olarak bantları ve harita projeksiyonunu belirterek bir resimden rastgele bir piksel karosu istemesine olanak tanır. Maskelenen veya eksik veriler sıfır olarak kodlanır.

İstekler, istek başına sıkıştırılmamış veri olarak 48 MB ile sınırlıdır. Bu değer, piksel cinsinden istek boyutlarının, istenen resim bantlarının sayısı ve her bant için piksel başına bayt sayısı çarpımı olarak hesaplanır. İstekler, her iki boyutta da en fazla 32.000 piksel ve en fazla 1.024 bantla sınırlıdır. Bu sınırları aşan istekler 400 (BAD_REQUEST) hata koduyla sonuçlanır.

Başarılı olursa yanıt metni, istekteki fileFormat alanında belirtilen kodlamada istenen piksel verilerini içerir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Piksellerin alınacağı resim öğesinin adı. name, "projects/*/assets/**" biçimindedir (ör. "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). Kullanıcıya ait tüm öğeler "earthengine-legacy" projesi kapsamındadır (ör. "projects/earthengine-legacy/assets/users/foo/bar"). Diğer tüm öğeler "earthengine-public" projesi kapsamındadır (ör. "projects/earthengine-public/assets/LANDSAT").

Yetkilendirme, belirtilen kaynak name için aşağıdaki IAM iznini gerektirir:

  • earthengine.assets.get

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
Alanlar
fileFormat

enum (ImageFileFormat)

Piksel değerlerinin döndürüleceği çıkış dosyası biçimi.
grid

object (PixelGrid)

Verilerin alınacağı piksel ızgarasını tanımlayan parametreler. Varsayılan olarak verilerin yerel piksel ızgarasıdır.
region

object (Struct format)

Varsa döndürülecek veri bölgesi. GeoJSON geometri nesnesi olarak belirtilir (bkz. RFC 7946). Döndürülen resim her zaman dikdörtgen olduğundan, çıkış koordinat sisteminde verilen geometrinin sınır kutusu aslında kullanılır. grid.dimensions de belirtilirse ızgara, istenen boyuta yeniden ölçeklendirilir.
bandIds[]

string

Varsa piksel alınacak belirli bir bant grubunu belirtir. Bantlar, bir ImageBand prototipinin id alanında belirtildiği gibi kimliğe göre tanımlanır.
visualizationOptions

object (VisualizationOptions)

Varsa ham verileri döndürmek yerine verilerin 8 bit RGB görselleştirmesini oluşturmak için uygulanacak bir görselleştirme seçenekleri grubu.
workloadTag

string

Bu hesaplamayı izlemek için kullanıcı tarafından sağlanan etiket.

Yanıt gövdesi

Başarılı olursa yanıt, biçimi yöntem tarafından tanımlanan genel bir HTTP yanıtıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • 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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.