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 directory में, 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 क्लाइंट आईडी
अगर आपको उपयोगकर्ताओं की पहचान की पुष्टि उनके खाते से करनी है (सेवा खाते का इस्तेमाल करने के बजाय), तो आपको अपने Cloud प्रोजेक्ट से 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 पर ले जाएं. बदलाव करने और उन्हें सेव करने के बाद, पेज को रीफ़्रेश करने पर वे अपने-आप दिखेंगे.