NPM इंस्टॉल करना

Earth Engine JavaScript API को npm पैकेज के तौर पर डिस्ट्रिब्यूट किया जाता है. यह GitHub पर होस्ट किया जाता है. यहां दिए गए निर्देशों में, Google Earth Engine JavaScript API इंस्टॉल करने के बारे में खास जानकारी दी गई है. Earth Engine JavaScript API का इस्तेमाल करने के लिए, आपको अपने कंप्यूटर पर क्लाइंट लाइब्रेरी और उसकी डिपेंडेंसी इंस्टॉल करनी होंगी. इसके बाद, पुष्टि करने के क्रेडेंशियल सेट अप करने होंगे.

JavaScript क्लाइंट लाइब्रेरी में, Earth Engine के कोड एडिटर की सभी सुविधाएं शामिल नहीं हैं. खास तौर पर, बटन, पैनल, और चार्ट जैसे यूज़र इंटरफ़ेस की सुविधाओं को शामिल नहीं किया जाता है.

क्लाइंट लाइब्रेरी इंस्टॉल करना

1. Node.js और npm सेट अप करना

npm, JavaScript और Node.js के लिए पैकेज मैनेजर है. पुष्टि करें कि आपके पास Node.js 6+ और npm 3+ हो.

node --version
npm --version

अगर ज़रूरत हो, तो अपने प्लैटफ़ॉर्म के लिए आधिकारिक इंस्टॉलर का इस्तेमाल करके, दोनों को इंस्टॉल करें.

2. Earth Engine की क्लाइंट लाइब्रेरी इंस्टॉल करना

क्लाइंट लाइब्रेरी को npm से इंस्टॉल किया जा सकता है. इसके लिए, यह कमांड इस्तेमाल करें:

npm install --save @google/earthengine

इंस्टॉल हो जाने के बाद, क्लाइंट लाइब्रेरी को मौजूदा प्रोजेक्ट डायरेक्ट्री में रखा जाता है: node_modules/@google/earthengine/*. आने वाले समय में प्रोजेक्ट के लिए, क्लाइंट को इसी तरीके से इंस्टॉल करें.

3. किसी ऐप्लिकेशन में क्लाइंट लाइब्रेरी का इस्तेमाल करना

अपने ऐप्लिकेशन कोड में, Earth Engine API को शामिल करें:

var ee = require('@google/earthengine');

क्लाइंट लाइब्रेरी अपडेट करना

क्लाइंट लाइब्रेरी को नए वर्शन में अपडेट करने के लिए, npm का इस्तेमाल करें. मौजूदा प्रोजेक्ट डायरेक्ट्री से: 
npm update @google/earthengine

npm की मदद से लाइब्रेरी अपडेट करने के बारे में ज़्यादा जानें.

क्लाइंट लाइब्रेरी अनइंस्टॉल करना

npm पैकेज मैनेजर का इस्तेमाल करके अनइंस्टॉल करने के लिए, यह कमांड चलाएं:

npm uninstall --save @google/earthengine

इससे मौजूदा प्रोजेक्ट से node_modules/@google/earthengine हट जाएगा. हालांकि, इससे एक ही मशीन पर मौजूद अन्य डायरेक्ट्री के किसी भी प्रोजेक्ट पर कोई असर नहीं पड़ेगा.

Cloud प्रोजेक्ट बनाना और Earth Engine API को चालू करना

Cloud प्रोजेक्ट बनाने और Earth Engine API को चालू करने के लिए, इन निर्देशों का पालन करें.

पुष्टि करने के लिए क्रेडेंशियल सेट अप करना

Earth Engine API, ब्राउज़र पर आधारित क्लाइंट की पुष्टि करने के लिए OAuth 2.0 प्रोटोकॉल का इस्तेमाल करते हैं. Node.js में सर्वर साइड पर पुष्टि करने के लिए, सेवा खातों का इस्तेमाल करने का सुझाव दिया जाता है. वेब ऐप्लिकेशन, इनमें से किसी भी तरीके का इस्तेमाल कर सकते हैं. इनके फ़ायदे और नुकसान के बारे में यहाँ बताया गया है.

OAuth की मदद से क्लाइंट-साइड पर पुष्टि करना

वेब ब्राउज़र में क्लाइंट-साइड पुष्टि की सुविधा का इस्तेमाल करके, आपके ऐप्लिकेशन के उपयोगकर्ता अपने Google खातों से लॉग इन करते हैं. इन उपयोगकर्ताओं के पास, Earth Engine को ऐक्सेस करने की अनुमति पहले से होनी चाहिए. साथ ही, उन्हें आपके ऐप्लिकेशन में इस्तेमाल की गई ऐसेट को पढ़ने की अनुमति भी होनी चाहिए.

OAuth 2.0 क्लाइंट आईडी बनाने के बाद, यहां दिए गए तरीके से पुष्टि करें. my-project को अपने Google Cloud प्रोजेक्ट आईडी से बदलें:

// Load client library.
var ee = require('@google/earthengine');

// Initialize client library and run analysis.
var initialize = function() {
  ee.initialize(null, null, function() {
    // ... run analysis ...
  }, function(e) {
    console.error('Initialization error: ' + e);
  }, null, 'my-project');
};

// Authenticate using an OAuth pop-up.
ee.data.authenticateViaOauth(YOUR_CLIENT_ID, initialize, function(e) {
  console.error('Authentication error: ' + e);
}, null, function() {
  ee.data.authenticateViaPopup(initialize);
});

सेवा खाते की मदद से सर्वर-साइड पर पुष्टि करना

सर्वर-साइड पुष्टि करने की सुविधा में, निजी कुंजी को आपके ऐप्लिकेशन के साथ सेव किया जाता है. इससे ऐप्लिकेशन को सेवा खाते के ज़रिए Earth Engine API को ऐक्सेस करने की अनुमति मिलती है. आपके ऐप्लिकेशन के उपयोगकर्ताओं को Earth Engine का ऐक्सेस पाने की ज़रूरत नहीं है. साथ ही, उन्हें लॉग इन करने की भी ज़रूरत नहीं है.

Node.js में, क्लाइंट लाइब्रेरी सिर्फ़ सर्वर-साइड पुष्टि करने की सुविधा देती है.

नया सेवा खाता बनाने के बाद, पुष्टि करने के लिए अपनी JSON निजी कुंजी का इस्तेमाल करें (my-project को अपने Google Cloud प्रोजेक्ट आईडी से बदलें):

// Require client library and private key.
var ee = require('@google/earthengine');
var privateKey = require('./.private-key.json');

// Initialize client library and run analysis.
var runAnalysis = function() {
  ee.initialize(null, null, function() {
    // ... run analysis ...
  }, function(e) {
    console.error('Initialization error: ' + e);
  }, null, 'my-project');
};

// Authenticate using a service account.
ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) {
  console.error('Authentication error: ' + e);
});

इंस्टॉलेशन की जांच करना

यह जांचने के लिए कि पुष्टि करने की सुविधा सही तरीके से सेट अप की गई है, यहां दी गई स्क्रिप्ट चलाएं (my-project को अपने Google Cloud प्रोजेक्ट आईडी से बदलें):

var ee = require('@google/earthengine');

// Authenticate using one (but not both) of the methods below.
ee.data.authenticateViaOauth(YOUR_CLIENT_ID);
ee.data.authenticateViaPrivateKey(YOUR_PRIVATE_KEY);

ee.initialize(null, null, null, null, null, 'my-project');

// Run an Earth Engine script.
var image = new ee.Image('srtm90_v4');
image.getMap({min: 0, max: 1000}, function(map) {
  console.log(map);
});

अगर सब कुछ सही तरीके से इंस्टॉल किया गया है, तो इमेज का मेटाडेटा प्रिंट होना चाहिए.