App Engine ve Earth Engine'a Genel Bakış

Google App Engine, Google'ın sunucularında kendi özel uygulamalarınızı oluşturup çalıştırmanıza olanak tanır. App Engine uygulamalarını, trafiğiniz ve veri depolama ihtiyaçlarınız değiştikçe kolayca oluşturabilir, bakımını yapabilir ve ölçeklendirebilirsiniz. Uygulama kaynak kodunuzu yüklemeniz yeterlidir. App Engine'de geliştirme konusunda yeniyseniz devam etmeden önce App Engine Python veya Node.js hızlı başlangıç kılavuzuna göz atın.

Ölçeklenebilir coğrafi uygulamalar oluşturmak için Earth Engine ve App Engine birlikte kullanılabilir. Genellikle App Engine kodunuz Earth Engine Python istemci kitaplığını içerir ve hizmet hesabı kullanarak Earth Engine arka ucuna istekte bulunur. Bu, herkesin oturum açmadan veya kayıtlı bir Earth Engine kullanıcısı olmadan uygulamanızı kullanmasına olanak tanıdığı için avantajlıdır. Standart Earth Engine kullanım sınırlarının her hizmet hesabı için geçerli olduğunu unutmayın.

Başka bir geliştirme yaklaşımı ise hizmet hesabı yerine istemci tarafı kimlik doğrulaması kullanmaktır. Bu yaklaşımla, uygulamanızı ziyaret eden kullanıcıların Earth Engine'e kayıtlı olması ve oturum açması gerekir. Bu yaklaşımın avantajı, Earth Engine'e yapılan isteklerin son kullanıcının kimlik bilgileri kullanılarak yapılmasıdır. Bu nedenle, kullanım sınırlarına ulaşma olasılığınız daha düşüktür. Kullanıcılarınızın uygulamayı kullanmadan önce Earth Engine'e kaydolup giriş yapması gerekir.

GitHub'daki Earth Engine App Engine demos dizini, bir dizi faydalı App Engine örneği içerir. Her örneğin kısa bir açıklaması için Örnek Uygulamalar sayfasına bakın. Bu dokümanda, örnekleri veya oluşturduğunuz özel uygulamaları ayarlama ve dağıtma talimatları verilmektedir.

Earth Engine ile App Engine uygulamalarını dağıtma

Aşağıdaki talimatlarda demo uygulamalarının nasıl dağıtılacağı açıklanmaktadır. Python talimatları Mac OS ve Linux için hazırlanmıştır. Windows'da Python kullanıyorsanız bu yöntemi deneyin.

Google Cloud projenizde Earth Engine API'yi etkinleştirme

Bir Google Cloud projesi oluşturun veya seçin ve bu talimatlara göre Earth Engine API'yi etkinleştirin.

Kimlik bilgilerini ayarlama

Hizmet Hesabı

Hizmet hesabı, uygulamanızı kullanan herkes adına Earth Engine'e yapılan istekleri yetkilendirmek için kullanılabilir. config.py dosyası, hizmet hesabı e-posta adresini ve özel anahtar dosyasını kullanarak kimlik doğrulama kodu içerir. Hizmet hesabıyla kimlik doğrulama ayarlamak için hizmet hesabını ve özel anahtar dosyasını oluşturmak üzere bu talimatları uygulayın. Anahtar dosyasına .private-key.json adını verin ve proje dizininize taşıyın.

Python

Henüz yapmadıysanız önce Earth Engine Python API'yi ayarlayın. Hizmet hesabını bu talimatlara göre test edin.

Test başarılı olursa config.py dosyasını (veya kaynak kodunuzdaki eşdeğer bir dosyayı) hizmet hesabınızın hesap e-posta adresiyle güncelleyin. (Anahtar dosyasının yolu, proje dizininizde olduğu için değişmemelidir.)

Node.js

npm install komutunu çalıştırarak projenin bağımlılıklarını yükleyin. Earth Engine Node.js API'si ve diğer bağımlılıklar, proje dizininizdeki ./node_modules klasörüne kopyalanır. Yükleme başarısız olursa Node.js'nin son sürümünün yüklü olup olmadığını kontrol edin. Kitaplığı kimlik doğrulayıp başlatın. my-project kısmını Google Cloud proje kimliğinizle değiştirin:

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

OAuth 2.0 istemci kimliği

Kullanıcıların kendileri olarak kimlik doğrulaması yapmasını (hizmet hesabı kullanmak yerine) istiyorsanız Cloud projenizden bir OAuth istemci kimliği oluşturmanız gerekir. Bunu yapmak için:

  1. Bu talimatlara göre bir istemci kimliği oluşturun.
  2. Müşteri kimliğinizi kullanmak için static/script.js (veya kaynak kodunuzdaki eşdeğer bir dosya) dosyasını güncelleyin.
  3. ee_api_js.js öğesinin /static/ dizininde (veya eşdeğerinde) bulunduğundan emin olun. Kitaplığı doğrudan GitHub'dan indirebilir, npm'den yükleyebilirsiniz veya EE API'nin tamamını içeren kod deposunu zaten klonladıysanız yerel dosya sisteminizdeki earthengine-api/javascript/build konumundan kopyalayabilirsiniz.

Yerel geliştirme ortamını ayarlama

Python

Projeyi indirmek ve oluşturmak için GitHub'daki her örnek dizinde yer alan talimatları uygulayın. build.sh dosyası varsa bunu uygulama kök klasörünüzden şu komutla çalıştırın:

./build.sh

Kurulum komut dosyası, sisteminizde henüz yoksa bağımlılıkları indirir ve Google komut satırı araçlarını yükler. Earth Engine Python API ve bağımlılıkları, proje dizininizdeki ./lib klasörüne kopyalanır.

Aşağıdaki komutu çalıştırarak App Engine komut satırı araçlarının kullanılabilir olduğunu doğrulayın:

dev_appserver.py

Komut bulunamazsa Google App Engine SDK for Python'ı manuel olarak indirip yüklemeyi deneyin. Komut kullanılabiliyorsa "error: too few arguments" (hata: çok az bağımsız değişken) hatasıyla başarısız olmalıdır.

Node.js

Kurulum gerekmez.

Yerel olarak çalıştırma

Hizmet hesabınız Earth Engine erişimi için kaydedildikten sonra, örnekleri test ederken kimlik doğrulamak için kullanabilirsiniz (bkz. config.py). Örnekleri önce proje dizininize gidip şu komutu çalıştırarak yerel olarak test etmeyi deneyin:

Python
dev_appserver.py .
Node.js
npm install
npm start

Uygulamanın yerel bir sunucuda çalıştığını görmek için tarayıcınızı http://localhost:8080 adresine yönlendirin. Yaptığınız (ve kaydettiğiniz) tüm değişiklikler, sayfayı yenilediğinizde otomatik olarak alınır.