Earth Engine erişimi

Earth Engine, Google Cloud'da çalışır ve erişim ile API yönetimi için Cloud projeleri gerekir. Tüm Earth Engine çağrıları (Kod Düzenleyici, istemci kitaplıkları, uygulamalar veya REST API'den) bir Cloud projesi üzerinden yönlendirilir. Bu sayede Cloud Console'da erişim denetimi, kaynak yönetimi ve kullanım izleme yapılabilir.

Earth Engine'e erişim elde etme

Earth Engine'i kullanmak için aşağıdaki özelliklere sahip bir Cloud projesine erişmeniz gerekir:

Proje oluşturma

Yeni bir Cloud projesi oluşturup kaydetmek veya mevcut bir projeyi kaydetmek için kayıt sayfasını ziyaret edin. Kayıttan sonra Earth Engine erişimi hemen etkinleştirilir.

Kayıt işlemi sırasında oluşturulan projeler Google Cloud Console'da yönetilebilir. Earth Engine API'yi Cloud Console'daki Earth Engine API sayfasından etkinleştirebilir veya devre dışı bırakabilirsiniz.

Manuel adımlar (kayıt sayfası tarafından otomatikleştirilir)

Cloud projesi oluşturma

Henüz oluşturmadıysanız bir Google Cloud projesi oluşturun. Bu işlemi Cloud Console'un projeler sayfasından yapabilir veya aşağıdaki düğmeyi tıklayabilirsiniz:

Cloud projesi oluşturma

Earth Engine API'yi etkinleştirme

Projeniz için Earth Engine API'yi etkinleştirmek üzere aşağıdaki düğmeyi tıklayarak Earth Engine API sayfasına gidin:

Earth Engine API'yi etkinleştirme

Earth Engine API sayfasında projenizi seçtiğinizden emin olun ve ETKİNLEŞTİR düğmesini tıklayın.

Projeyi ticari veya ticari olmayan kullanım için kaydetme

Projeniz için aşağıdaki URL'yi düzenleyin, sayfayı ziyaret edin ve kayıt akışını tamamlayın.

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

Öğe klasörü oluşturma (isteğe bağlı)

earthengine create folder komutunu kullanarak, erişiminiz olan bir Cloud projesiyle ilişkili Earth Engine öğeleri klasörü oluşturabilirsiniz. Bunun için burada açıklandığı şekilde bir yol kullanmanız gerekir. Örneğin:

earthengine create folder projects/my-project/assets/

Öğeler panelinde projeyi ekleyerek kod düzenleyicide bir proje için öğe klasörü de oluşturabilirsiniz.

Projede öğe depolamayı planlamıyorsanız bu klasörü oluşturmanız gerekmez.

Mevcut bir projeyi kullanma

Earth Engine için yapılandırılmış mevcut Cloud projeleri hakkında kuruluşunuzun BT personeliyle görüşün. Earth Engine hizmetlerine erişmek için kullanacağınız Google Hesabı'na projede doğru rollerin ve izinlerin verildiğinden emin olun.

Proje belirtin

Aşağıdaki bölümlerde, Earth Engine hizmetlerinin çeşitli arayüzleri için bir projenin nasıl belirtileceği açıklanmaktadır.

İstemci kitaplıkları (Python, JavaScript)

ee.Initialize() işlevi, Python ve JavaScript istemci kitaplıklarından gelen Earth Engine istekleri için bir proje belirtmek amacıyla kullanılır. Proje spesifikasyonunu yapılandırmanın birkaç yolu vardır. Daha fazla bilgi için kimlik doğrulama ve başlatma sayfasını inceleyin.

Kod Düzenleyici

Kod Düzenleyici'nin sağ üst köşesindeki profil simgesini tıklayın ve menüden "Change Cloud Project"i (Cloud Projesini Değiştir) seçin. Seçim iletişim kutusundan bir proje seçin.

Earth Engine Uygulamaları

Earth Engine uygulaması yayınlarken istekleri yönlendirmek için bir proje seçmeniz istenir. Yayınlama iletişim kutusundaki talimatları uygulayın.

Komut satırı aracı

Komut satırı aracından gelen Earth Engine çağrılarını bir Cloud projesiyle ilişkilendirmek için earthengine çağrınızda --project parametresini kullanın veya varsayılan bir proje ayarlamak için set_project komutunu kullanın.

REST API

REST API çağrılarını bir Cloud projesiyle ilişkilendirmek için kimlik doğrulamanın oauth2 tarafından yapıldığı kimliği doğrulanmış HTTP çağrıları gönderin. Yerel bir ortamda gcloud komutunu kullanabilirsiniz. Bir Cloud projesiyle ilişkili hizmet hesabını da kullanabilirsiniz. Bir hizmet hesabıyla kimlik doğrulaması yapmak için google.oath.service_account.Credentials.from_service_account_file() kullanma örneğini REST API hızlı başlangıç kılavuzunda bulabilirsiniz.

Proje erişimini yapılandırma

Aşağıdaki bölümlerde, Earth Engine özellikli projelerin diğer kişiler ve hizmet hesapları tarafından kullanılmak üzere nasıl yapılandırılacağı açıklanmaktadır.

Hizmet hesapları

Hizmet hesapları, üst projeleri kaydedildikten ve Earth Engine API etkinleştirildikten sonra otomatik olarak erişim elde eder. Ayrıca projede doğru izinlere sahip olmaları gerekir. Bir projedeki herhangi bir sayıda hizmet hesabı, Earth Engine'i kullanacak şekilde yapılandırılabilir. Earth Engine ile hizmet hesaplarını kullanma hakkında daha fazla bilgi edinmek için hizmet hesapları sayfasını ziyaret edin.

Google Hesapları

Cloud projeleri, rolleri ve izinleri yönetmek için Cloud IAM'i kullanır. Diğer kullanıcıların projeniz üzerinden Earth Engine'e erişebilmesi için Cloud Console'u kullanarak onlara doğru rolleri ve izinleri vermeniz gerekir.

OAuth 2.0 istemci kimliği

Bir projeden OAuth 2.0 istemci kimliği oluşturmanız gerekebilir. Örneğin, kullanıcı kimlik bilgilerini Earth Engine'e ileten bir uygulama oluşturmak için bu kimliği kullanabilirsiniz. Cloud Console menüsüne () gidip API'ler ve Hizmetler > Kimlik Bilgileri'ni seçerek Cloud projenizin kimlik bilgilerini yönetebilirsiniz. (İstenirse projeyi seçin).

Proje için yeni bir istemci kimliği oluşturmak üzere + KİMLİK BİLGİLERİ OLUŞTUR > OAuth istemci kimliği > Web uygulaması'nı tıklayın.

Web uygulamasının yapılandırmasında:

  • Yetkilendirilmiş JavaScript kaynaklarını belirtin. Örneğin:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Yetkilendirilmiş yönlendirme URI'lerini belirtin. Örneğin:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

OAuth ile kullanıcıların kimliğini doğrulama hakkında daha fazla bilgi edinin.

Sık karşılaşılan senaryolar

Eğitim amaçlı bir ders veriyorum...

Mükemmel! Ticari olmayan bir proje kaydederseniz faturalandırma yapılandırması gerekmez. Ardından, öğrencilerinizi projeye ekleyebilirsiniz.

Operasyon ekibinin/ticari kuruluşun bir parçasıyım...

Mükemmel! Ticari kullanım için bir proje kaydedebilir ve ortak çalışanlarınızı projeye ekleyebilirsiniz. Lütfen seçtiğiniz Earth Engine aboneliğindeki koltuk sınırına da dikkat edin.

Earth Engine verilerini silme

Hesap düzeyinde silme

Hesap düzeyinde silme işlemi, hesabınızdaki tüm Earth Engine verilerini kaldırır.

Hesabınız bir Google Workspace kuruluşunun parçasıysa hesap verilerinizi yöneticiniz kontrol eder. Bir yönetici Google Hesabı'nı sildiğinde, ilişkili tüm Earth Engine verileri yaklaşık 30 gün içinde silinir.

Earth Engine ekibinin silinen verileri kurtarması mümkün değildir.

Cloud projeleri

Bir Cloud projesi silindiğinde, bu projeyle ilişkili Earth Engine verilerinin (ör. proje kökünde depolanan tüm öğeler, proje düzeyindeki tüm EE uygulamaları, izleme verileri vb.) silinmesi tetiklenir. Bu işlem 30 güne kadar geri alınabilir olabilir ancak 30 gün sonra bu verileri kurtarmak hiçbir şekilde mümkün değildir.

Öğeler

Öğelerinizi silmenin en basit yöntemi, Earth Engine öğelerinizi görüntülemek ve manuel olarak silmek için Kod Düzenleyici'deki "Öğeler" sekmesini kullanmaktır.

Kimliği projects/{project-id}/assets/{asset-id} olan bir öğenin programatik olarak silinmesi için (ör. projects/my-project/assets/my-asset):

Python istemcisi

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

JavaScript istemcisi

Kod Düzenleyici'nin güvenlik korumalı alanının, bu çağrının ilgili ortamda çalışmasını engellediğini unutmayın.

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

Komut satırı aracı

rm komutunu kullanın:

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

Kod Düzenleyici komut dosyaları

Earth Engine Kod Düzenleyici komut dosyalarınızı silmek için:

Kod Düzenleyici

Kod Düzenleyici'deki "Komut Dosyaları" sekmesinden bir komut dosyası veya depo seçip silin. Silindi olarak işaretlenen depolar 30 gün içinde kurtarılamaz hale gelir.

Git'i kullanma

İleri düzey kullanıcılar, komut dosyalarını yönetmek için Git'i kullanabilir. Görüntüleyebileceğiniz depoları listelemek için https://earthengine.googlesource.com/ adresine gidin.

Earth Engine Uygulamaları

Earth Engine Uygulamalarınızı silmek için Kod Düzenleyici'deki "Uygulamalar" düğmesini kullanarak Uygulamalarınızı yönetin.

Kod Düzenleyici'deki "Bağlantı Al" bağlantılarınızı görüntülemek ve silmek için Bağlantıları Yönet sayfasını kullanın. Bu sayfaya, "Bağlantıyı Al" düğmesinin yanındaki açılır menüde "Bağlantıları Yönet" seçeneğine giderek ulaşabilirsiniz.

Ticari olmayan erişimi yapılandırma

Projeniz için ticari olmayan (ücretsiz) Earth Engine erişimi ayarlamak istiyorsanız projenizin uygunluğunu onaylamak üzere Cloud Console'daki kayıt anketini doldurmanız gerekir.

Doğrulama

Earth Engine, çok sayıda işlem kaynağına ücretsiz erişim sağladığından Google, ticari olmayan erişim için kaydolan her projenin doğrulanmasını zorunlu kılar. Doğrulama süreci, kayıt işleminin bir parçası olarak gerçekleştirilir. Doğrulama anketini doldurursanız ve projenizin ticari olduğu belirlenirse Earth Engine'i ücretsiz olarak kullanamazsınız.

26 Eylül 2025'ten itibaren tüm ticari olmayan projelerin Cloud Console'daki anketi doldurması gerekir. Doğrulama sürecini en kısa sürede tamamlamanızı öneririz. 26 Eylül 2025'ten önce işlem yapmazsanız projenizin Earth Engine'e erişimi, doğrulama sürecini tamamlayana kadar duraklatılır.

Yeniden doğrulama

Ticari olmayan erişime sahip tüm projelerin, erişim için düzenli olarak yeniden doğrulanması gerekir.

Ticari erişimi yapılandırma

Projeniz için ticari (ücretli) Earth Engine erişimi ayarlamak istiyorsanız kayıt sayfasını kullanarak projeyi yapılandırmanız ve faturalandırma hesabında bir plan seçmeniz gerekir.

Ticari erişimi sonlandırma

Earth Engine'in doğrudan müşterisiyseniz ve Earth Engine'i ücretli bir bağlamda kullanmayı bırakmak istiyorsanız ücretlendirmeyi durdurmak için birkaç değişiklik yapmanız gerekir:

  • Abonelik ücretlerini durdurma

    • Faturalandırma hesabınızdaki Earth Engine aboneliğini sonlandırmak için "Planları Yönet" sayfasını kullanmanız gerekir. Bu sayfaya, faturalandırma hesabına bağlı kayıtlı bir Cloud projesi kullanırken Kod Düzenleyici'nin sağ üst kısmındaki kullanıcı ayarları açılır menüsünden erişebilirsiniz.
    • "Planları Yönet" sayfasına doğrudan bir faturalandırma hesabından da erişebilirsiniz:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • "Sınırlı" planı seçtiğinizde, faturalandırma hesabınızdan mevcut faturalandırma döneminizden sonra başka Earth Engine platformu abonelik ücreti alınmaz.

  • İşlem ücretlerini durdurma

    • İşlemle (EECU süresi) ilgili yeni ücretlendirmeleri önlemek için Cloud projelerinizde Earth Engine API'yi devre dışı bırakın. Bu işlem, devam eden istekleri sonlandırmaz veya depolanan nesneleri silmez. Bu nedenle, API devre dışı bırakılmış olsa bile Earth Engine ücretleri ödemeniz gerekebilir.
    • API'leri devre dışı bırakma hakkında bilgi için API Konsolu Yardımı'na bakın.
  • Depolama ücretlerini durdurma

    • Depolanan Earth Engine öğeleri, API devre dışı bırakılsa bile maliyet oluşturmaya devam eder. Öğelerinizi sildiğinizde daha fazla EE depolama alanı ücreti ödemezsiniz.