Method: projects.locations.thumbnails.create

ऐसा आईडी बनाता है जिसका इस्तेमाल "थंबनेल" इमेज को रेंडर करने के लिए किया जा सकता है.

इसका इस्तेमाल GetThumbnailPixels के साथ किया जाता है. thumbnails.create को कॉल करने पर, आपको एक्सप्रेशन और आउटपुट के कुछ विकल्प मिलते हैं. thumbnails.create का नतीजा एक आईडी होता है, जो उस एक्सप्रेशन का आकलन करने और उन विकल्पों को लागू करने के नतीजे के तौर पर एक इमेज दिखाता है. इसके बाद, GetThumbnailPixels को कॉल करके, नतीजे में मिली पूरी इमेज का डेटा पाया जा सकता है. यह आईडी कुछ घंटों के लिए मान्य होगा.

एंडपॉइंट के इस जोड़े के लिए, सबसे आम इस्तेमाल का उदाहरण यह है कि thumbnails.create पर POST के ज़रिए कोई जटिल एक्सप्रेशन दिया जाए. इसके बाद, GetThumbnailPixels पर GET के ज़रिए कैलकुलेट की गई इमेज फ़ेच की जाए. दो चरणों वाली इस प्रोसेस का इस्तेमाल, ComputePixels की तुलना में ज़्यादा स्थितियों में किया जा सकता है. खास तौर पर: - एन्कोड की गई इमेज के बाइट पाने के लिए, ComputePixels के नतीजे को अनरैप करना होगा. GetThumbnailPixels का नतीजा, सीधे ब्राउज़र से दिखाया जा सकता है. - ComputePixels को सिर्फ़ अनुमति वाला उपयोगकर्ता, सही दायरे वाले OAuth टोकन का इस्तेमाल करके कॉल कर सकता है. thumbnails.create पर भी यही पाबंदी है. हालांकि, GetThumbnailPixels को एपीआई कुंजी वाले यूआरएल से शुरू किया जा सकता है. इसलिए, इसे शुरू करने वाले यूआरएल का इस्तेमाल ज़्यादा बड़े पैमाने पर किया जा सकता है.

एक्सप्रेशन का आकलन करने के नतीजे को, अनुरोध किए गए इमेज फ़ॉर्मैट की कुछ ज़रूरी शर्तों को पूरा करना होगा. खास तौर पर, JPEG या PNG फ़ॉर्मैट के लिए ज़रूरी है कि एक या तीन आउटपुट बैंड हों. साथ ही, क्लिप की वैल्यू 0 से 255 की रेंज से बाहर होनी चाहिए.

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

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

POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/thumbnails

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. थंबनेल कलेक्शन का पैरंट (उदाहरण के लिए, "projects/*").

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

  • earthengine.thumbnails.create

क्वेरी पैरामीटर

पैरामीटर
workloadTag

string

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

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

अनुरोध के मुख्य भाग में Thumbnail का उदाहरण है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Thumbnail का नया इंस्टेंस शामिल किया जाता है.

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

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