Google App Engine की मदद से, Google के सर्वर पर अपने कस्टम ऐप्लिकेशन बनाए और चलाए जा सकते हैं. App Engine ऐप्लिकेशन बनाना, उन्हें मैनेज करना, और उन्हें स्केल करना आसान है. ऐसा इसलिए, क्योंकि ट्रैफ़िक और डेटा स्टोरेज की आपकी ज़रूरतें बदलती रहती हैं. आपको बस अपने ऐप्लिकेशन का सोर्स कोड अपलोड करना होगा और यह इस्तेमाल के लिए तैयार हो जाएगा. अगर आप App Engine के लिए ऐप्लिकेशन डेवलप करने वाले नए डेवलपर हैं, तो आगे बढ़ने से पहले App Engine Python या Node.js की क्विकस्टार्ट गाइड ज़रूर देखें.
Earth Engine और App Engine का इस्तेमाल एक साथ करके, बड़े पैमाने पर जियोस्पेशल ऐप्लिकेशन बनाए जा सकते हैं. आम तौर पर, आपके App Engine कोड में Earth Engine Python क्लाइंट लाइब्रेरी शामिल होती है. साथ ही, यह सेवा खाते का इस्तेमाल करके, Earth Engine के बैकएंड को अनुरोध भेजता है. यह फ़ायदेमंद है, क्योंकि इससे कोई भी व्यक्ति आपके ऐप्लिकेशन का इस्तेमाल कर सकता है. इसके लिए, उसे लॉग इन करने या Earth Engine का रजिस्टर किया गया उपयोगकर्ता होने की ज़रूरत नहीं है. ध्यान दें कि Earth Engine के इस्तेमाल करने की सामान्य सीमाएं हर सेवा खाते पर लागू होती हैं.
डेवलपमेंट का दूसरा तरीका यह है कि सेवा खाते के बजाय, क्लाइंट-साइड ऑथेंटिकेशन का इस्तेमाल किया जाए. इस तरीके का इस्तेमाल करने पर, आपके ऐप्लिकेशन पर आने वाले लोगों को Earth Engine के लिए रजिस्टर करना होगा और लॉग इन करना होगा. इस तरीके का फ़ायदा यह है कि Earth Engine को किए जाने वाले अनुरोध, असली उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करके किए जाते हैं. इसलिए, इस्तेमाल करने की सीमाएं पूरी होने की संभावना कम होती है. इसमें समस्या यह है कि आपके उपयोगकर्ताओं को ऐप्लिकेशन इस्तेमाल करने से पहले, Earth Engine के लिए साइन अप करना होगा और लॉग इन करना होगा.
GitHub पर मौजूद Earth Engine App Engine demos डायरेक्ट्री में, App Engine के काम के उदाहरणों का एक सेट मौजूद है. हर उदाहरण के बारे में कम शब्दों में जानकारी पाने के लिए, उदाहरण के तौर पर दिए गए ऐप्लिकेशन पेज पर जाएं. इस दस्तावेज़ में, आपके बनाए गए उदाहरणों या कस्टम ऐप्लिकेशन को सेट अप और डिप्लॉय करने के निर्देश दिए गए हैं.
Earth Engine की मदद से, App Engine ऐप्लिकेशन डिप्लॉय करना
यहां दिए गए निर्देशों में, डेमो ऐप्लिकेशन को डिप्लॉय करने का तरीका बताया गया है. Python के निर्देश, Mac OS और Linux के लिए हैं. अगर Windows पर Python का इस्तेमाल किया जा रहा है, तो यह तरीका आज़माएं.
अपने Google Cloud प्रोजेक्ट पर Earth Engine API को चालू करना
कोई Google Cloud प्रोजेक्ट बनाएं या चुनें. इसके बाद, इन निर्देशों के मुताबिक Earth Engine API को चालू करें.
क्रेडेंशियल सेट अप करना
सेवा खाता
सेवा खाते का इस्तेमाल, आपके ऐप्लिकेशन का इस्तेमाल करने वाले व्यक्ति की ओर से Earth Engine को किए गए अनुरोधों को अनुमति देने के लिए किया जा सकता है. config.py फ़ाइल में, सेवा खाते के ईमेल पते और निजी पासकोड वाली फ़ाइल का इस्तेमाल करके, पुष्टि करने वाला कोड शामिल होता है. सेवा खाते की मदद से पुष्टि करने की सुविधा सेट अप करने के लिए,
इन निर्देशों का पालन करके सेवा खाता
और निजी पासकोड फ़ाइल बनाएं. कुंजी वाली फ़ाइल को .private-key.json नाम दें और उसे अपनी प्रोजेक्ट डायरेक्ट्री में ले जाएं.
Python
अगर आपने अब तक ऐसा नहीं किया है, तो पहले Earth Engine Python API सेट अप करें. इन निर्देशों के मुताबिक, सेवा खाते की जांच करें.
अगर टेस्ट सफल हो जाता है, तो अपने सेवा खाते के ईमेल पते की मदद से, config.py (या अपने सोर्स कोड में मौजूद मिलती-जुलती फ़ाइल) को अपडेट करें. (कुंजी वाली फ़ाइल का पाथ नहीं बदलना चाहिए, क्योंकि यह आपके प्रोजेक्ट की डायरेक्ट्री में है).
Node.js
npm install चलाकर, प्रोजेक्ट की डिपेंडेंसी इंस्टॉल करें. Earth Engine
Node.js API और अन्य डिपेंडेंसी, आपकी प्रोजेक्ट डायरेक्ट्री में मौजूद ./node_modules
फ़ोल्डर में कॉपी हो जाएंगी. अगर इंस्टॉलेशन पूरा नहीं हो पाता है, तो देखें कि Node.js का नया वर्शन इंस्टॉल किया गया है या नहीं. लाइब्रेरी की पुष्टि करें और उसे शुरू करें. इसके लिए, my-project की जगह अपना Google Cloud प्रोजेक्ट आईडी डालें:
const ee = require('@google/earthengine'); ee.data.authenticateViaPrivateKey('.private-key.json'); ee.initialize(null, null, null, null, null, 'my-project');
OAuth 2.0 क्लाइंट आईडी
अगर आपको उपयोगकर्ताओं को सेवा खाते का इस्तेमाल करने के बजाय, खुद की पहचान की पुष्टि करने की सुविधा देनी है, तो आपको अपने क्लाउड प्रोजेक्ट से OAuth क्लाइंट आईडी सेट अप करना होगा. ऐसा करने के लिए:
- इन निर्देशों के मुताबिक, क्लाइंट आईडी सेट अप करें.
- अपने क्लाइंट आईडी का इस्तेमाल करने के लिए,
static/script.js(या अपने सोर्स कोड में मौजूद मिलती-जुलती फ़ाइल) को अपडेट करें. - पक्का करें कि
ee_api_js.js,/static/डायरेक्ट्री (या इसके जैसी किसी डायरेक्ट्री) में उपलब्ध हो. इसे सीधे GitHub से डाउनलोड किया जा सकता है, npm से इंस्टॉल किया जा सकता है या अगर आपने पहले से ही पूरी EE API रिपॉज़िटरी का क्लोन बनाया है, तो इसे अपने लोकल फ़ाइल सिस्टम परearthengine-api/javascript/buildसे कॉपी किया जा सकता है.
लोकल डेवलपमेंट एनवायरमेंट सेट अप करना
Python
प्रोजेक्ट को डाउनलोड करने और बनाने के लिए, GitHub पर मौजूद हर उदाहरण डायरेक्ट्री में दिए गए निर्देशों का पालन करें. अगर कोई build.sh फ़ाइल है, तो उसे अपने ऐप्लिकेशन के रूट फ़ोल्डर से इस निर्देश के साथ चलाएं:
./build.sh
निर्देशों की स्क्रिप्ट, डिपेंडेंसी डाउनलोड करेगी और Google के कमांड लाइन टूल इंस्टॉल करेगी. ऐसा तब होगा, जब वे आपके सिस्टम पर पहले से मौजूद न हों. Earth Engine Python API और इसकी डिपेंडेंसी, आपकी प्रोजेक्ट डायरेक्ट्री में मौजूद ./lib फ़ोल्डर में कॉपी हो जाएंगी.
यह पुष्टि करें कि App Engine के कमांड लाइन टूल उपलब्ध हैं. इसके लिए, यह कमांड चलाएं:
dev_appserver.py
अगर कमांड नहीं मिलता है, तो Google App Engine SDK for Python को मैन्युअल तरीके से डाउनलोड और इंस्टॉल करके देखें. अगर कमांड उपलब्ध है, तो उसे "error: too few arguments" के साथ फ़ेल हो जाना चाहिए.
Node.js
सेटअप करने की ज़रूरत नहीं है.
लोकल तौर पर चलाएं
जब आपका सेवा खाता, Earth Engine को ऐक्सेस करने के लिए रजिस्टर हो जाए, तो उदाहरणों को टेस्ट करते समय, पुष्टि करने के लिए इसका इस्तेमाल किया जा सकता है (config.py देखें). पहले अपनी प्रोजेक्ट डायरेक्ट्री में जाकर, उदाहरणों को स्थानीय तौर पर टेस्ट करें. इसके लिए, यह कमांड चलाएं:
Python
dev_appserver.py .
Node.js
npm install npm start
लोकल सर्वर पर चल रहे ऐप्लिकेशन को देखने के लिए, अपने ब्राउज़र में http://localhost:8080 पर जाएं. पेज को रीफ़्रेश करने पर, आपके किए गए और सेव किए गए सभी बदलाव अपने-आप लागू हो जाएंगे.