Method: projects.maps.create

एक आईडी बनाता है, जिसका इस्तेमाल किसी कैलकुलेशन के नतीजे दिखाने वाली मैप टाइल को रेंडर करने के लिए किया जा सकता है. इस आईडी का इस्तेमाल, GetTile अनुरोधों के हिस्से के तौर पर किया जाना चाहिए.

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

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

  • earthengine.maps.create

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

पैरामीटर
workloadTag

string

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

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

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

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

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

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

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