Ringkasan App Engine & Earth Engine

Google App Engine memungkinkan Anda membuat dan menjalankan aplikasi kustom Anda sendiri di server Google. Aplikasi App Engine mudah dibuat, dikelola, dan diskalakan seiring perubahan kebutuhan traffic dan penyimpanan data Anda berubah. Anda cukup mengupload kode sumber aplikasi dan aplikasi siap digunakan. Jika Anda baru mengembangkan aplikasi untuk App Engine, pastikan untuk melihat panduan memulai App EnginePython atauNode.js sebelum melanjutkan.

Earth Engine dan App Engine dapat digunakan bersama-sama untuk membuat aplikasi geospasial yang skalabel. Biasanya, kode App Engine Anda menyertakan Earth Engine Python client library 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 kumpulan contoh App Engine yang berguna. Lihat halaman Aplikasi Contoh untuk mengetahui deskripsi singkat setiap contoh. Dokumen ini memberikan petunjuk tentang 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 mengotorisasi permintaan ke Earth Engine atas nama siapa pun yang menggunakan aplikasi Anda. config.py file 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, pastikan Node.js versi terbaru telah diinstal. Autentikasi dan inisialisasi library, dengan mengganti my-project dengan ID project Google Cloud Anda:

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

Client ID OAuth 2.0

Jika Anda ingin pengguna mengautentikasi diri mereka sendiri (bukan menggunakan akun layanan), Anda harus menyiapkan Client ID OAuth dari Project Cloud Anda. 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 the project. Jika ada file build.sh, eksekusi 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.

Verifikasi bahwa alat command line App Engine tersedia dengan menjalankan:

dev_appserver.py

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

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 Anda menguji contoh. Coba uji contoh secara lokal terlebih dahulu dengan membuka direktori project Anda 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.