Earth Engine erişimi

Earth Engine, Google Cloud'da çalışır ve erişim ile API yönetimi için Cloud projeleri gerektirir. Tüm Earth Engine çağrıları (Code Editor, istemci kitaplıkları, uygulamalar veya REST API'den bağımsız olarak) bir Cloud projesi üzerinden yönlendirilir. Bu sayede Cloud Console'da erişim kontrolü, kaynak yönetimi ve kullanım izleme sağlanır.

Earth Engine'e erişme

Earth Engine'i kullanmak için aşağıdaki koşulları karşılayan 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ına gidin. 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 yapmadıysanız bir Google Cloud projesi oluşturun. Bunu 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

Projenizde Earth Engine API'yi etkinleştirmek için 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

Projenizin aşağıdaki URL'sini 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 bir Earth Engine varlıkları klasörü oluşturabilirsiniz. Bu klasörü oluşturmak için burada açıklandığı gibi bir yol kullanın. Örneğin: 

earthengine create folder projects/my-project/assets/

Ayrıca, Öğe panelinde projeyi ekleyerek Kod Düzenleyici'de bir proje için öğe klasörü 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 iletişime geçin. Earth Engine hizmetlerine erişmek için kullanacağınız Google Hesabı'na projede doğru rollerin ve izinlerin verildiğinden emin olun.

Proje belirtme

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

İstemci kitaplıkları (Python, JavaScript)

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

Kod Düzenleyici

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

Earth Engine Uygulamaları

Earth Engine uygulaması yayınlarken isteklerin yönlendirileceği 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'ye yapılan çağrıları 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. Cloud projesiyle ilişkili bir hizmet hesabı da kullanabilirsiniz. google.oath.service_account.Credentials.from_service_account_file() kullanarak hizmet hesabıyla kimlik doğrulama örneği için REST API Hızlı Başlangıç Kılavuzu'na bakın.

Proje erişimini yapılandırma

Aşağıdaki bölümlerde, Earth Engine'in etkinleştirildiği projeleri diğer kişiler ve hizmet hesapları tarafından kullanılacak şekilde nasıl yapılandıracağınız açıklanmaktadır.

Hizmet hesapları

Hizmet hesapları, üst projeleri kaydedilip Earth Engine API etkinleştirildikten sonra otomatik olarak erişime sahip olur. Ayrıca, proje içinde doğru izinlere sahip olmaları gerekir. Bir projede Earth Engine'i kullanmak üzere istenen sayıda hizmet hesabı 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

Örneğin, kullanıcı kimlik bilgilerini Earth Engine'e ileten bir uygulama oluşturmak için bir projeden OAuth 2.0 istemci kimliği oluşturmanız gerekebilir. 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

Kullanıcıların kimliğini OAuth ile 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.

Bir operasyon ekibinin/ticari kuruluşun parçasıyım...

Mükemmel! Projeleri ticari kullanım için kaydedebilir ve ortak çalışanlarınızı 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.

Silinen veriler Earth Engine ekibi tarafından kurtarılamaz.

Bulut projeleri

Bir Cloud projesi silindiğinde, bu projeyle ilişkili Earth Engine verileri de silinir (örneğin, proje kökünde depolanan tüm öğeler, proje düzeyindeki tüm EE uygulamaları, izleme verileri vb.). Bu işlem 30 gün içinde geri alınabilir ancak 30 gün sonra bu verileri kurtarmak 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üzenleyicideki "Öğeler" sekmesini kullanmaktır.

projects/{project-id}/assets/{asset-id} kimlikli 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 söz konusu 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 Code Editor komut dosyalarınızı silmek için:

Kod Düzenleyici

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

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/ adresini ziyaret edin.

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üzenleyicideki "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 üzere Cloud Console'da kayıt anketini doldurarak projenizin uygunluğunu onaylamanız gerekir.

Doğrulama

Earth Engine, çok sayıda bilgi işlem kaynağına ücretsiz erişim sağladığı için Google, ticari olmayan erişim için kaydedilen her projenin doğrulanmasını zorunlu kılar. Doğrulama işlemi kayıt sırasında yapılır. Doğrulama anketini doldurursanız ve projenizin ticari olduğu belirlenirse Earth Engine'i ödeme yapmadan kullanamazsınız.

26 Eylül 2025'ten itibaren tüm ticari olmayan projeler için Cloud Console'daki anketi doldurmak zorunlu olacak. Doğrulama sürecini en kısa sürede tamamlamanızı öneririz. 26 Eylül 2025'ten önce işlem yapmazsanız doğrulama işlemini tamamlayana kadar projenizin Earth Engine'e erişimi 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şimini ayarlamak üzere 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 bağlamda kullanmayı bırakmak istiyorsanız ücretlendirilmenin durdurulması 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 faturalandırma hesabına bağlı kayıtlı bir Cloud projesi kullanırken Code Editor'ın sağ üst kısmındaki kullanıcı ayarları açılır menüsünden erişilebilir).

    • Faturalandırma hesabı için "Planları Yönet" sayfasına doğrudan da erişebilirsiniz:

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

    • "Sınırlı" planı seçtiğinizde, mevcut faturalandırma döneminizden sonra faturalandırma hesabınızdan başka Earth Engine platformu abonelik ücreti alınmaz.

  • Bilgi işlem ücretlerini durdurma

    • Bilgi işlemle (EECU süresi) ilgili yeni ücretlerin alınmasını önlemek için Cloud projelerinizde Earth Engine API'yi devre dışı bırakın. Bu işlemin, devam eden istekleri sonlandırmadığını veya depolanan nesneleri silmediğini unutmayın. Bu nedenle, API devre dışı bırakılmış olsa bile Earth Engine ücretleri almaya devam edebilirsiniz.
    • API'leri devre dışı bırakma hakkında bilgi edinmek için API Konsolu Yardım'a bakın.

  • Depolama alanı ücretlerini durdurma

    • API devre dışı olsa bile depolanan Earth Engine öğeleri maliyetleri artırmaya devam eder. Öğelerinizi silmeniz, daha fazla EE depolama ücreti ödemenizi engeller.