App Engine और Earth Engine के बारे में खास जानकारी

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 डेमो की डायरेक्ट्री में, 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 एपीआई और अन्य सभी डिपेंडेंसी को, आपकी प्रोजेक्ट डायरेक्ट्री के ./node_modules फ़ोल्डर में कॉपी कर दिया जाएगा. अगर इंस्टॉल नहीं हो पाता है, तो देखें कि Node.js का नया वर्शन इंस्टॉल किया गया है या नहीं.

const ee = require('@google/earthengine');
ee.data.authenticateViaPrivateKey('.private-key.json');
ee.initialize();

OAuth 2.0 क्लाइंट आईडी

अगर आपको उपयोगकर्ताओं को सेवा खाते का इस्तेमाल करने के बजाय, खुद के तौर पर पुष्टि करने की अनुमति देनी है, तो आपको अपने Cloud प्रोजेक्ट से OAuth क्लाइंट आईडी सेट अप करना होगा. ऐसा करने के लिए:

1. इन निर्देशों के मुताबिक क्लाइंट आईडी सेट अप करें.
2. अपने क्लाइंट आईडी का इस्तेमाल करने के लिए, static/script.js (या अपने सोर्स कोड में मिलती-जुलती फ़ाइल) को अपडेट करें.
3. पक्का करें कि 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

अगर कमांड नहीं मिलता है, तो मैन्युअल तरीके से Python के लिए Google App Engine SDK टूल को डाउनलोड और इंस्टॉल करें. अगर कमांड उपलब्ध है, तो यह "गड़बड़ी: बहुत कम आर्ग्युमेंट" के साथ काम नहीं करेगा.

Node.js

इसके लिए कुछ भी सेट अप करने की ज़रूरत नहीं है.

स्थानीय तौर पर चलाना

जब आपका सेवा खाता Earth Engine को ऐक्सेस करने के लिए रजिस्टर हो जाता है, तो उदाहरणों की जांच करते समय, पुष्टि करने के लिए इसका इस्तेमाल किया जा सकता है (config.py देखें). सबसे पहले, उदाहरणों को स्थानीय तौर पर टेस्ट करें. इसके लिए, अपनी प्रोजेक्ट डायरेक्ट्री में जाकर, ये निर्देश चलाएं:

Python

dev_appserver.py .

Node.js

npm install
npm start

लोकल सर्वर पर चल रहे ऐप्लिकेशन को देखने के लिए, अपने ब्राउज़र को http://localhost:8080 पर ले जाएं. पेज को रीफ़्रेश करने पर, आपके किए गए और सेव किए गए सभी बदलाव अपने-आप लागू हो जाएंगे.