Earth Engine JavaScript API, GitHub'da barındırılan bir npm paketi olarak dağıtılır. Aşağıdaki talimatlarda, Google Earth Engine JavaScript API'nin yüklenmesiyle ilgili genel bilgiler verilmektedir. Earth Engine JavaScript API'yi kullanmak için bilgisayarınıza istemci kitaplığını ve bağımlılıklarını yüklemeniz, ardından kimlik doğrulama bilgilerini ayarlamanız gerekir.
JavaScript istemci kitaplığı, Earth Engine Kod Düzenleyici'nin tüm işlevlerini içermez. Düğmeler, paneller ve grafikler gibi kullanıcı arayüzü özellikleri hariç tutulur.
İstemci kitaplığını yükleme
1. Node.js ve npm'yi ayarlama
npm, JavaScript ve Node.js için bir paket yöneticisidir. Node.js 6+ ve npm 3+ sürümlerine sahip olduğunuzu doğrulayın.
node --version npm --version
Gerekirse platformunuzun resmi yükleyicisini kullanarak ikisini de yükleyin.
2. Earth Engine istemci kitaplığını yükleme
İstemci kitaplığı, aşağıdaki komutla npm'den yüklenebilir:
npm install --save @google/earthengine
İstemci kitaplığı yüklendikten sonra mevcut proje dizinine (node_modules/@google/earthengine/*) yerleştirilir. Gelecekteki projelerde istemciyi aynı şekilde yükleyin.
3. İstemci kitaplığını bir uygulamada kullanma
Uygulama kodunuzda Earth Engine API'yi zorunlu kılın:
var ee = require('@google/earthengine');
İstemci kitaplığını güncelleme
İstemci kitaplığını en yeni sürüme güncellemek için npm'yi kullanın. Mevcut proje dizininden:npm update @google/earthengine
npm ile kitaplıkları güncelleme hakkında daha fazla bilgi edinin .
İstemci kitaplığını kaldırma
npm paket yöneticisini kullanarak kaldırmak için aşağıdaki komutu çalıştırın:
npm uninstall --save @google/earthengine
Bu işlem, node_modules/@google/earthengine öğesini mevcut projeden kaldırır ancak aynı makinedeki diğer dizinlerde bulunan projeleri etkilemez.
Cloud projesi oluşturma ve Earth Engine API'yi etkinleştirme
Cloud projesi oluşturmak ve Earth Engine API'yi etkinleştirmek için bu talimatları uygulayın.
Kimlik doğrulama bilgilerini ayarlama
Earth Engine API'leri, tarayıcı tabanlı istemcilerin kimlik doğrulamasını yapmak için OAuth 2.0 protokolünü kullanır. Node.js'de sunucu tarafı kimlik doğrulama için hizmet hesapları önerilir. Web uygulamaları her iki yaklaşımı da kullanabilir. Bu yaklaşımların avantajları ve dezavantajları aşağıda ele alınmıştır.
OAuth ile istemci tarafı kimlik doğrulama
Web tarayıcısında istemci tarafı kimlik doğrulama kullanıldığında uygulamanızın kullanıcıları kendi Google Hesaplarıyla giriş yapar. Bu kullanıcıların Earth Engine'e erişim yetkisi ve uygulamanız tarafından kullanılan öğeleri okuma izni olmalıdır.
OAuth 2.0 istemci kimliği oluşturduktan sonra aşağıda gösterildiği gibi kimlik doğrulaması yapın (my-project yerine Google Cloud proje kimliğinizi girin):
// 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); });
Hizmet hesabı ile sunucu tarafı kimlik doğrulama
Sunucu tarafı kimlik doğrulamada, uygulamanızda özel bir anahtar depolanır. Bu anahtar, uygulamanın bir hizmet hesabı üzerinden Earth Engine API'ye erişmesine olanak tanır. Uygulamanızın kullanıcılarının Earth Engine'e kendi erişimlerinin olması ve giriş yapmaları gerekmez.
Node.js'de istemci kitaplığı yalnızca sunucu tarafı kimlik doğrulama sağlar.
Yeni bir hizmet hesabı oluşturduktan sonra kimlik doğrulaması için JSON özel anahtarınızı kullanın (my-project yerine Google Cloud proje kimliğinizi girin):
// 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); });
Kurulumu test etme
Kimlik doğrulamanın doğru şekilde ayarlandığını test etmek için aşağıdaki komut dosyasını çalıştırın
(my-project ifadesini Google Cloud proje kimliğinizle değiştirin):
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); });
Her şey doğru şekilde yüklendiyse bir resmin meta verileri yazdırılır.