Akses Earth Engine

Earth Engine berjalan di Google Cloud dan memerlukan project Cloud untuk akses dan pengelolaan API. Semua panggilan Earth Engine (baik dari Editor Kode, library klien, Aplikasi, atau REST API) dirutekan melalui project Cloud, sehingga memungkinkan kontrol akses, pengelolaan resource, dan pemantauan penggunaan di Konsol Cloud.

Mendapatkan akses ke Earth Engine

Untuk menggunakan Earth Engine, Anda memerlukan akses ke project Cloud yang:

Membuat project

Buka halaman pendaftaran untuk membuat dan mendaftarkan project Cloud baru atau mendaftarkan project yang sudah ada.

Project yang dibuat selama proses pendaftaran dapat dikelola di Konsol Google Cloud. Anda dapat mengaktifkan atau menonaktifkan Earth Engine API dari halaman Earth Engine API di Cloud Console.

Langkah manual (otomatis oleh halaman pendaftaran)

Buat project Cloud

Jika Anda belum melakukannya, buat Project Google Cloud. Anda dapat melakukannya dari halaman project di Cloud Console atau klik tombol berikut:

Buat project Cloud

Aktifkan Earth Engine API

Untuk mengaktifkan Earth Engine API untuk project Anda, klik tombol berikut untuk membuka halaman Earth Engine API:

Aktifkan Earth Engine API

Di halaman Earth Engine API, pastikan Anda telah memilih project, lalu klik tombol AKTIFKAN.

Mendaftarkan project untuk penggunaan komersial atau nonkomersial

Edit URL berikut untuk project Anda, buka halaman tersebut, dan selesaikan alur pendaftaran. 

https://code.earthengine.google.com/register?project=my-project

Membuat folder aset (opsional)

Anda dapat membuat folder aset Earth Engine yang terkait dengan project Cloud yang dapat Anda akses menggunakan perintah earthengine create folder dengan jalur seperti yang dijelaskan di sini. Contoh: 

earthengine create folder projects/my-project/assets/

Anda juga dapat membuat folder aset untuk project di Editor Kode dengan menambahkan project di panel Aset.

Anda tidak perlu membuat folder ini kecuali jika Anda berencana menyimpan aset dalam project.

Menggunakan project yang sudah ada

Tanyakan kepada staf IT organisasi Anda tentang project Cloud yang sudah ada yang dikonfigurasi untuk Earth Engine. Pastikan Akun Google yang akan Anda gunakan untuk mengakses layanan Earth Engine diberi peran dan izin yang benar di project.

Menentukan project

Bagian berikut menjelaskan cara menentukan project untuk berbagai antarmuka ke layanan Earth Engine.

Library klien (Python, JavaScript)

Fungsi ee.Initialize() digunakan untuk menentukan project bagi permintaan Earth Engine yang berasal dari library klien Python dan JavaScript. Ada beberapa cara untuk mengonfigurasi spesifikasi project, lihat halaman autentikasi dan inisialisasi untuk mengetahui detail selengkapnya.

Editor Kode

Klik ikon profil di sudut kanan atas Editor Kode, lalu pilih "Ubah Project Cloud" dari menu. Pilih project dari dialog pilihan.

Aplikasi Earth Engine

Saat memublikasikan Aplikasi Earth Engine, Anda akan diminta untuk memilih project yang akan digunakan untuk merutekan permintaan. Ikuti petunjuk dalam dialog publikasi.

Alat command line

Untuk mengaitkan panggilan Earth Engine dari alat command line dengan project Cloud, gunakan parameter --project dalam panggilan Anda ke earthengine atau gunakan set_project untuk menetapkan project default.

REST API

Untuk mengaitkan panggilan ke REST API dengan project Cloud, lakukan panggilan HTTP yang diautentikasi dengan autentikasi yang ditangani oleh oauth2. Di lingkungan lokal, Anda dapat menggunakan perintah gcloud. Anda juga dapat menggunakan akun layanan yang terkait dengan Project Cloud. Lihat Panduan memulai REST API untuk contoh penggunaan google.oath.service_account.Credentials.from_service_account_file() guna melakukan autentikasi dengan akun layanan.

Mengonfigurasi akses project

Bagian berikut menjelaskan cara mengonfigurasi project yang mendukung Earth Engine untuk digunakan oleh individu dan akun layanan lain.

Akun layanan

Akun layanan otomatis memiliki akses setelah project induknya didaftarkan dan Earth Engine API diaktifkan. Mereka juga memerlukan izin yang benar dalam project. Sejumlah akun layanan di project dapat dikonfigurasi untuk menggunakan Earth Engine. Buka halaman akun layanan untuk mempelajari lebih lanjut cara menggunakan akun layanan dengan Earth Engine.

Akun Google

Project Cloud menggunakan Cloud IAM untuk mengelola peran dan izin. Agar orang lain dapat mengakses Earth Engine melalui project Anda, Anda harus menggunakan Cloud Console untuk memberi mereka peran dan izin yang benar.

ID Klien OAuth 2.0

Anda mungkin perlu membuat ID Klien OAuth 2.0 dari project, misalnya untuk membuat aplikasi yang meneruskan kredensial pengguna ke Earth Engine. Anda dapat mengelola kredensial untuk project Cloud dengan membuka menu Cloud Console () dan memilih APIs & Services > Credentials. (Pilih project jika diminta).

Untuk membuat Client ID baru untuk project, klik + CREATE CREDENTIALS > OAuth client ID > Web application.

Dalam konfigurasi aplikasi web:

  • Tentukan asal JavaScript yang diizinkan, misalnya:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Tentukan URI pengalihan yang sah, misalnya:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Pelajari lebih lanjut cara mengautentikasi pengguna dengan OAuth.

Skenario umum

Saya mengajar kelas pendidikan...

Bagus! Jika Anda mendaftarkan project nonkomersial, tidak diperlukan konfigurasi penagihan. Kemudian, Anda dapat menambahkan siswa ke project.

Saya adalah bagian dari tim operasional/organisasi komersial...

Bagus! Anda dapat mendaftarkan project untuk penggunaan komersial, dan menambahkan kolaborator ke project tersebut. Perhatikan juga batas kursi dalam langganan Earth Engine yang Anda pilih.

Penghapusan data Earth Engine

Penghapusan tingkat akun

Penghapusan tingkat akun akan menghapus semua data Earth Engine dari akun Anda.

Jika akun Anda adalah bagian dari organisasi Google Workspace, administrator Anda akan mengontrol data akun Anda. Jika administrator menghapus Akun Google, semua data Earth Engine terkait akan dihapus dalam waktu sekitar 30 hari.

Tim Earth Engine tidak dapat memulihkan data setelah data tersebut dihapus.

Project Cloud

Saat project Cloud dihapus, tindakan ini akan memicu penghapusan data Earth Engine yang terkait dengan project tersebut (termasuk, misalnya, aset apa pun yang disimpan di root project, Aplikasi EE tingkat project, data Pemantauan, dll.). Proses ini dapat dibatalkan hingga 30 hari, tetapi data tersebut tidak akan pernah dapat dipulihkan setelah 30 hari.

Aset

Metode paling sederhana untuk menghapus aset Anda adalah dengan menggunakan tab "Aset" di Editor Kode untuk melihat dan menghapus aset Earth Engine Anda secara manual.

Untuk penghapusan aset terprogram dari aset dengan ID projects/{project-id}/assets/{asset-id} (misalnya, projects/my-project/assets/my-asset):

Klien Python

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Klien JavaScript

Perhatikan bahwa sandbox keamanan Editor Kode mencegah panggilan ini berfungsi di lingkungan tersebut.

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Alat command line

Gunakan perintah rm:

earthengine rm projects/my-project/assets/my-asset

Skrip Editor Kode

Untuk menghapus skrip Editor Kode Earth Engine Anda:

Editor Kode

Dari "tab Skrip" di Editor Kode, pilih skrip atau repositori, lalu hapus. Setelah repositori ditandai sebagai dihapus, repositori tersebut tidak dapat dipulihkan dalam waktu 30 hari.

Menggunakan Git

Pengguna tingkat lanjut dapat menggunakan Git untuk mengelola skrip mereka. Lihat https://earthengine.googlesource.com/ untuk mencantumkan repositori yang dapat Anda lihat.

Aplikasi Earth Engine

Untuk menghapus Aplikasi Earth Engine, gunakan tombol"Aplikasi" di Editor Kode untuk mengelola Aplikasi Anda.

Gunakan halaman Kelola Link untuk melihat dan menghapus link "Dapatkan Link" dari Editor Kode. Halaman ini dapat ditemukan dengan membuka opsi"Kelola Link" di menu drop-down di samping tombol "Dapatkan Link".

Mengonfigurasi akses nonkomersial

Untuk menyiapkan akses Earth Engine nonkomersial (tanpa biaya) untuk project Anda, Anda harus mengisi kuesioner pendaftaran di konsol Cloud untuk mengonfirmasi kelayakan project Anda.

Verifikasi

Karena Earth Engine memberikan akses tanpa biaya ke sejumlah besar resource komputasi, Google mewajibkan verifikasi setiap project yang terdaftar untuk akses nonkomersial. Proses verifikasi dilakukan sebagai bagian dari pendaftaran. Jika Anda menyelesaikan kuesioner verifikasi dan project Anda ditentukan sebagai komersial, Anda tidak akan memenuhi syarat untuk menggunakan Earth Engine tanpa membayar.

Mulai 26 September 2025, semua project nonkomersial harus mengisi kuesioner di Konsol Cloud. Sebaiknya selesaikan proses verifikasi sesegera mungkin. Jika Anda tidak mengambil tindakan sebelum 26 September 2025, akses proyek Anda ke Earth Engine akan dijeda hingga Anda menyelesaikan proses verifikasi.

Verifikasi ulang

Semua project dengan akses nonkomersial harus diverifikasi ulang untuk mendapatkan akses secara berkala.

Mengonfigurasi akses komersial

Untuk menyiapkan akses Earth Engine komersial (berbayar) untuk project Anda, Anda harus mengonfigurasi project menggunakan halaman pendaftaran dan memilih paket di akun penagihan.

Menghentikan akses komersial

Jika Anda adalah pelanggan langsung Earth Engine dan ingin berhenti menggunakan Earth Engine dalam konteks berbayar, ada beberapa perubahan yang perlu dilakukan untuk berhenti dikenai biaya:

  • Menghentikan tagihan langganan

    • Untuk menghentikan langganan Earth Engine di akun penagihan Anda, Anda harus menggunakan halaman "Kelola Paket" (dapat diakses dari menu drop-down setelan pengguna di kanan atas Editor Kode saat menggunakan project Cloud terdaftar yang ditautkan ke akun penagihan tersebut).

    • Anda juga dapat mengakses halaman "Kelola Paket" langsung untuk akun penagihan:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • Memilih paket "Terbatas" akan menghentikan akun penagihan Anda dari dikenai biaya langganan platform Earth Engine lebih lanjut setelah siklus penagihan saat ini.

  • Menghentikan biaya komputasi

    • Untuk mencegah biaya baru terkait komputasi (waktu EECU), nonaktifkan Earth Engine API di project Cloud Anda. Perhatikan bahwa tindakan ini tidak menghentikan permintaan yang sedang berlangsung atau menghapus objek yang disimpan, sehingga Anda mungkin masih dikenai biaya Earth Engine meskipun API dinonaktifkan.
    • Lihat Bantuan Konsol API untuk mengetahui informasi tentang cara menonaktifkan API.

  • Menghentikan biaya penyimpanan

    • Aset Earth Engine yang disimpan terus menimbulkan biaya meskipun API dinonaktifkan. Menghapus aset Anda akan menghentikan pengenaan biaya penyimpanan EE lebih lanjut.