NPM Yükleme

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'sinin yüklenmesine genel bir bakış sunulmaktadır. Earth Engine JavaScript API'yi kullanmak için istemci kitaplığını ve bağımlılıkları bilgisayarınıza yüklemeniz, ardından kimlik doğrulama kimlik 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 bu kapsamda değildir.

İ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 veya sonraki bir sürümün ve npm 3 veya sonraki bir sürümün yüklü olduğunu 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

Yüklendikten sonra istemci kitaplığı, geçerli proje dizinine yerleştirilir: node_modules/@google/earthengine/*. 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 son sürüme güncellemek için npm'yi kullanın. Mevcut proje dizininden: 
npm update @google/earthengine

Kitaplıkları npm ile 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 dosyasını mevcut projeden kaldırır ancak aynı makinedeki diğer dizinlerdeki projeleri etkilemez.

Cloud projesi oluşturun ve Earth Engine API'yi etkinleştirin

Cloud projesi oluşturmak ve Earth Engine API'yi etkinleştirmek için bu talimatları uygulayın.

Kimlik Doğrulama Kimlik Bilgilerini Ayarlama

Earth Engine API'leri, tarayıcı tabanlı istemcilerin kimliğini doğrulamak 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 açıklanmıştır.

OAuth ile istemci tarafı kimlik doğrulaması

Web tarayıcısında istemci tarafı kimlik doğrulama kullanıldığında, uygulamanızın kullanıcıları kendi Google hesaplarıyla oturum açar. Bu kullanıcıların Earth Engine'a erişme yetkisi ve uygulamanızın kullandığı öğeleri okuma izni olmalıdır.

OAuth 2.0 istemci kimliği oluşturduktan sonra aşağıdaki gibi kimlik doğrulaması yapın:

// 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);
  });
};

// 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ıyla sunucu tarafı kimlik doğrulaması

Sunucu tarafı kimlik doğrulamasında, uygulamanızla birlikte bir özel anahtar saklanır. Bu anahtar, uygulamanızın bir hizmet hesabı üzerinden Earth Engine API'ye erişmesine olanak tanır. Uygulamanızın kullanıcılarının Earth Engine'a kendi erişimlerinin olması veya oturum açmaları gerekmez.

Node.js'de istemci kitaplığı yalnızca sunucu tarafı kimlik doğrulaması sağlar.

Yeni bir hizmet hesabı oluşturduktan sonra JSON özel anahtarınızı kullanarak kimlik doğrulama yapın:

// 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);
  });
};

// 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:

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();

// 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 takılmışsa bir resmin meta verileri yazdırılır.