Ringkasan App Engine & Earth Engine

Google App Engine memungkinkan Anda mem-build dan menjalankan aplikasi kustom Anda sendiri di server Google. Aplikasi App Engine mudah dibuat, dikelola, dan diskalakan seiring perubahan kebutuhan penyimpanan data dan traffic Anda. Anda cukup mengupload kode sumber aplikasi dan siap digunakan. Jika Anda baru dalam pengembangan untuk App Engine, pastikan untuk melihat panduan memulai App Engine Python atau Node.js sebelum melanjutkan.

Earth Engine dan App Engine dapat digunakan bersama untuk membuat aplikasi geospasial yang skalabel. Biasanya, kode App Engine Anda menyertakan library klien Earth Engine Python dan membuat permintaan ke backend Earth Engine menggunakan akun layanan. Hal ini menguntungkan karena memungkinkan siapa saja menggunakan aplikasi Anda tanpa login atau menjadi pengguna Earth Engine terdaftar. Perhatikan bahwa batas penggunaan Earth Engine standar berlaku untuk setiap akun layanan.

Pendekatan pengembangan lainnya adalah menggunakan autentikasi sisi klien, bukan akun layanan. Dengan pendekatan ini, pengunjung aplikasi Anda harus terdaftar untuk Earth Engine dan login. Manfaat pendekatan ini adalah permintaan ke Earth Engine dibuat menggunakan kredensial pengguna akhir, sehingga Anda cenderung tidak akan mencapai batas penggunaan. Tantangannya adalah pengguna Anda harus mendaftar ke Earth Engine dan login sebelum menggunakan aplikasi.

Direktori demo Earth Engine App Engine di GitHub berisi serangkaian contoh App Engine yang berguna. Lihat halaman Contoh Aplikasi untuk mengetahui deskripsi singkat setiap contoh. Dokumen ini memberikan petunjuk cara menyiapkan dan men-deploy contoh atau aplikasi kustom yang Anda buat.

Men-deploy aplikasi App Engine dengan Earth Engine

Petunjuk berikut menjelaskan cara men-deploy aplikasi demo. Petunjuk Python ditujukan untuk Mac OS dan Linux. Jika Anda menggunakan Python di Windows, coba ini.

Mengaktifkan Earth Engine API di project Google Cloud Anda

Buat atau pilih project Google Cloud dan aktifkan Earth Engine API sesuai dengan petunjuk ini.

Menyiapkan kredensial

Akun Layanan

Akun layanan dapat digunakan untuk memberikan otorisasi permintaan ke Earth Engine atas nama siapa pun yang menggunakan aplikasi Anda. File config.py berisi kode autentikasi menggunakan alamat email akun layanan dan file kunci pribadi. Untuk menyiapkan autentikasi dengan akun layanan, ikuti petunjuk ini untuk membuat akun layanan dan file kunci pribadi. Beri nama file kunci .private-key.json dan pindahkan ke direktori project Anda.

Python

Jika belum, siapkan Earth Engine Python API terlebih dahulu. Uji akun layanan sesuai dengan petunjuk ini.

Jika pengujian berhasil, perbarui config.py (atau file yang setara dalam kode sumber Anda) dengan alamat email akun layanan Anda. (Jalur ke file kunci tidak boleh berubah karena berada di direktori project Anda).

Node.js

Instal dependensi project dengan menjalankan npm install. Earth Engine Node.js API dan dependensi lainnya akan disalin ke folder ./node_modules di direktori project Anda. Jika penginstalan gagal, periksa apakah Node.js versi terbaru telah diinstal. 

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

Client ID OAuth 2.0

Jika Anda ingin pengguna mengautentikasi sebagai diri mereka sendiri (bukan menggunakan akun layanan), Anda perlu menyiapkan Client ID OAuth dari Project Cloud. Untuk melakukannya:

  1. Siapkan client ID sesuai dengan petunjuk ini.
  2. Perbarui static/script.js (atau file yang setara dalam kode sumber Anda) untuk menggunakan client ID Anda.
  3. Pastikan ee_api_js.js tersedia di direktori /static/ (atau yang setara). Anda dapat mendownloadnya langsung dari GitHub, menginstalnya dari npm, atau, jika Anda telah meng-clone seluruh repo EE API, salin dari earthengine-api/javascript/build di sistem file lokal Anda.

Menyiapkan lingkungan pengembangan lokal

Python

Ikuti petunjuk di setiap direktori contoh di GitHub untuk mendownload dan mem-build project. Jika ada file build.sh, jalankan dari folder root aplikasi Anda dengan perintah:

./build.sh

Skrip penyiapan akan mendownload dependensi dan menginstal alat command line Google, jika belum ada di sistem Anda. Earth Engine Python API dan dependensinya akan disalin ke folder ./lib di direktori project Anda.

Pastikan alat command line App Engine tersedia dengan menjalankan:

dev_appserver.py

Jika perintah tidak ditemukan, coba download dan instal SDK Google App Engine untuk Python secara manual. Jika tersedia, perintah akan gagal dengan "error: terlalu sedikit argumen".

Node.js

Tidak perlu penyiapan.

Menjalankan secara lokal

Setelah akun layanan Anda terdaftar untuk akses Earth Engine, Anda dapat menggunakannya untuk melakukan autentikasi (lihat config.py) saat menguji contoh. Coba uji contoh secara lokal terlebih dahulu dengan membuka direktori project dan menjalankan:

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

Arahkan browser Anda ke http://localhost:8080 untuk melihat aplikasi yang berjalan di server lokal. Setiap perubahan yang Anda buat (dan simpan) akan otomatis diambil saat Anda memuat ulang halaman.