Method: projects.assets.getPixels

किसी इमेज ऐसेट से पिक्सल फ़ेच करता है. इस कस्टम तरीके की मदद से, कॉलर किसी इमेज से पिक्सल की अपनी पसंद की टाइल का अनुरोध कर सकता है. इसके लिए, बैंड और मैप प्रोजेक्शन की जानकारी देना ज़रूरी नहीं है. मास्क किया गया या मौजूद न होने वाला डेटा, शून्य के तौर पर कोड में बदल दिया जाएगा.

हर अनुरोध के लिए, अनकंप्रेस किए गए डेटा की सीमा 48 एमबी है. इसे पिक्सल में अनुरोध के डाइमेंशन, अनुरोध की गई इमेज बैंड की संख्या, और हर बैंड के लिए हर पिक्सल की बाइट की संख्या के प्रॉडक्ट के तौर पर कैलकुलेट किया जाता है. अनुरोधों के लिए, किसी भी डाइमेंशन में ज़्यादा से ज़्यादा 32K पिक्सल और ज़्यादा से ज़्यादा 1024 बैंड की सीमा तय है. इन सीमाओं से ज़्यादा अनुरोध करने पर, गड़बड़ी का कोड 400 (BAD_REQUEST) दिखेगा.

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में अनुरोध किए गए पिक्सल डेटा को, अनुरोध के fileFormat फ़ील्ड में बताए गए कोड में शामिल किया जाता है.

एचटीटीपी अनुरोध

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

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उस इमेज ऐसेट का नाम जिससे पिक्सल पाने हैं. name का फ़ॉर्मैट "projects/*/assets/**" है (उदाहरण के लिए, "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). उपयोगकर्ता के मालिकाना हक वाली सभी एसेट, "earthengine-legacy" प्रोजेक्ट में शामिल होती हैं. उदाहरण के लिए, "projects/earthengine-legacy/assets/users/foo/bar"). बाकी सभी एसेट, "earthengine-public" प्रोजेक्ट के तहत आती हैं. उदाहरण के लिए, "projects/earthengine-public/assets/LANDSAT").

अनुमति पाने के लिए, दिए गए संसाधन name पर IAM की यह अनुमति ज़रूरी है:

  • earthengine.assets.get

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "region": {
    object
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
फ़ील्ड
fileFormat

enum (ImageFileFormat)

आउटपुट फ़ाइल का फ़ॉर्मैट, जिसमें पिक्सल वैल्यू दिखानी हैं.
grid

object (PixelGrid)

ऐसे पैरामीटर जिनसे उस पिक्सल ग्रिड के बारे में पता चलता है जिसमें डेटा फ़ेच करना है. यह डिफ़ॉल्ट रूप से, डेटा के नेटिव पिक्सल ग्रिड पर सेट होता है.
region

object (Struct format)

अगर मौजूद है, तो डेटा का वह क्षेत्र जिसे दिखाना है. इसे GeoJSON ज्यामिति ऑब्जेक्ट के तौर पर दिखाया जाता है (RFC 7946 देखें). रिटर्न की गई इमेज हमेशा आयताकार होती है. इसलिए, आउटपुट कोऑर्डिनेट सिस्टम में दी गई ज्यामिति के बाउंडिंग बॉक्स का इस्तेमाल किया जाएगा. अगर grid.dimensions भी तय किया गया है, तो आखिर में ग्रिड को अनुरोध किए गए साइज़ में फिर से स्केल कर दिया जाएगा.
bandIds[]

string

अगर मौजूद है, तो यह बैंड के किसी खास सेट के बारे में बताता है, ताकि पिक्सल हासिल किए जा सकें. बैंड की पहचान आईडी से की जाती है, जैसा कि ImageBand प्रोटो के id फ़ील्ड से पता चलता है.
visualizationOptions

object (VisualizationOptions)

अगर मौजूद है, तो विज़ुअलाइज़ेशन के विकल्पों का एक सेट, जो रॉ डेटा दिखाने के बजाय, डेटा का 8-बिट आरजीबी विज़ुअलाइज़ेशन दिखाने के लिए लागू किया जाता है.
workloadTag

string

इस कैलकुलेशन को ट्रैक करने के लिए, उपयोगकर्ता का दिया गया टैग.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो रिस्पॉन्स एक सामान्य एचटीटीपी रिस्पॉन्स होता है. इसका फ़ॉर्मैट, तरीके के हिसाब से तय होता है.

अनुमति के दायरे

इसके लिए, 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

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.