अगर initialize() को एसिंक्रोनस मोड में पहली बार कॉल किया जाता है (सक्सेस कॉलबैक पास करके), तो एसिंक्रोनस मोड में किए जाने वाले सभी कॉल, अपनी कॉलबैक को एक कतार में जोड़ देंगे. इसके बाद, सभी कॉलबैक एक साथ चलाए जाएंगे.
अगर एसिंक्रोनस मोड में कई कॉल करने के बाद सिंक्रोनस मोड में कॉल किया जाता है, तो यह पहले से दिए गए सभी कॉलबैक को ब्लॉक कर देगा और उन्हें तब तक नहीं लौटाएगा, जब तक कि कॉल पूरा नहीं हो जाता.
ज़्यादातर मामलों में, लाइब्रेरी को शुरू करने से पहले, अनुमति देने वाला टोकन सेट किया जाना चाहिए. इसके लिए, ee.data.authorize() या ee.data.setAuthToken() का इस्तेमाल किया जा सकता है.
Python में, इस तरीके को ee.Initialize कहा जाता है. इसमें I कैपिटल लेटर में होता है. ध्यान दें कि JavaScript और Python के कुछ पैरामीटर अलग-अलग होते हैं. नीचे दिए गए opt_url और प्रोजेक्ट के अलावा, Python इन चीज़ों के साथ भी काम करता है: क्रेडेंशियल - google.oauth2.Credentials ऑब्जेक्ट या सेव किए गए क्रेडेंशियल का इस्तेमाल करने के लिए 'persistent' (डिफ़ॉल्ट); http_transport - httplib2.Http क्लाइंट.
इस्तेमाल | रिटर्न |
---|---|
ee.initialize(baseurl, tileurl, successCallback, errorCallback, xsrfToken, project) |
आर्ग्यूमेंट | टाइप | विवरण |
---|---|---|
baseurl | स्ट्रिंग, ज़रूरी नहीं | Earth Engine REST API का एंडपॉइंट. (Python आर्ग्युमेंट का नाम: opt_url) |
tileurl | स्ट्रिंग, ज़रूरी नहीं | Earth Engine REST टाइल एंडपॉइंट. यह ज़रूरी नहीं है और डिफ़ॉल्ट रूप से baseurl पर सेट होता है. (सिर्फ़ JavaScript) |
successCallback | फ़ंक्शन, ज़रूरी नहीं है | यह एक वैकल्पिक कॉलबैक है. इसे तब लागू किया जाता है, जब शुरू करने की प्रोसेस पूरी हो जाती है. अगर यह विकल्प नहीं दिया जाता है, तो शुरुआत सिंक्रोनस तरीके से की जाती है. (सिर्फ़ JavaScript) |
errorCallback | फ़ंक्शन, ज़रूरी नहीं है | यह एक वैकल्पिक कॉलबैक है. अगर शुरू करने में गड़बड़ी होती है, तो इसे गड़बड़ी के साथ शुरू किया जाता है. (सिर्फ़ JavaScript) |
xsrfToken | स्ट्रिंग, ज़रूरी नहीं | यह एक स्ट्रिंग है, जिसे EE API XHR के "xsrfToken" पैरामीटर में पास किया जाता है. (सिर्फ़ JavaScript) |
project | स्ट्रिंग, ज़रूरी नहीं | एपीआई कॉल करते समय इस्तेमाल करने के लिए, क्लाइंट प्रोजेक्ट आईडी या नंबर (ज़रूरी नहीं). (Python आर्ग्युमेंट का नाम: project) |