Earth Engine için JavaScript'e Giriş

Bu eğitimde, Earth Engine komut dosyaları yazmaya başlamanız için yeterli düzeyde JavaScript bilgisi verilmektedir. Daha kapsamlı JavaScript eğitimleri için bu Mozilla geliştirici kaynaklarına göz atın. JavaScript örnekleriyle programlamaya giriş için Eloquent JavaScript'e bakın. JavaScript kodlama stiliyle ilgili öneriler için Google JavaScript Stil Rehberi'ne bakın. Bu eğitimde, Earth Engine Kod Düzenleyici'de JavaScript yazacaksınız. Başlamadan önce, Kod Düzenleyici ortamını tanımak için Kod Düzenleyici kılavuzunu kullanın.

Merhaba Dünya!

Earth Engine için ilk JavaScript'inizi yazma zamanı geldi. Chrome tarayıcınızda code.earthengine.google.com adresine gidin ve aşağıdakileri Kod Düzenleyici'ye kopyalayın:

Kod Düzenleyici (JavaScript)

print('Hello World!');

Run'ı (Çalıştır) tıklayın ve "Hello world!" ifadesinin Console sekmesine yazdırıldığını görün. Yukarıdaki satır bir JavaScript ifadesidir. JavaScript'te ifadeler noktalı virgülle biter. Earth Engine programları, bunun gibi bir dizi ifadeden oluşur. Kodu silmeden çalışmasını önlemek için yorum satırı haline getirebilirsiniz. Kodu açıklama satırı yapmanın yollarından biri, çalıştırmak istemediğiniz kodun önüne iki eğik çizgi // koymaktır. Örneğin:

Kod Düzenleyici (JavaScript)

// print('Hello World!');

Kodunuza ne yapmaya çalıştığınızı açıklayan çok sayıda yorum eklemek iyi bir uygulamadır. Ayrıca artık hiçbir şey yapmayan yorumlanmış kodları silmek de iyi bir uygulamadır. Bu iki uygulama da kodun okunabilirliğini artırır.

Temel JavaScript veri türleri

Dize

Nesneleri ve temel öğeleri depolamak için değişkenlerin kullanılması, kodun okunabilirliğini artırır. Örneğin, dize nesnesi depolayan bir değişken, tek ' veya çift " tırnak işaretiyle tanımlanır (ancak bunları karıştırmayın) ve tek tırnak işareti tercih edilir. Yeni bir dize oluşturun ve bunu greetString adlı bir değişkende saklayın:

Kod Düzenleyici (JavaScript)

// Use single (or double) quotes to make a string.
var greetString = 'Ahoy there!';
// Use parentheses to pass arguments to functions.
print(greetString);

Numbers

Değişkenlerin var anahtar kelimesiyle tanımlandığını unutmayın. Değişkenler sayıları da depolayabilir:

Kod Düzenleyici (JavaScript)

// Store a number in a variable.
var number = 42;
print('The answer is:', number);

Bu örnekte, print() komutuna virgülle ayrılmış iki bağımsız değişken verildiğinde her bağımsız değişkenin farklı bir satıra yazdırıldığına dikkat edin.

Listeler

Listeleri köşeli parantezlerle [] tanımlayın. Sayı listesi, örneğin:

Kod Düzenleyici (JavaScript)

// Use square brackets [] to make a list.
var listOfNumbers = [0, 1, 1, 2, 3, 5];
print('List of numbers:', listOfNumbers);

Listeler, dizeleri veya diğer nesneleri de depolayabilir. Örneğin:

Kod Düzenleyici (JavaScript)

// Make a list of strings.
var listOfStrings = ['a', 'b', 'c', 'd'];
print('List of strings:', listOfStrings);

Nesneler

JavaScript'teki nesneler, key: value çiftlerinden oluşan sözlüklerdir. Süslü parantezleri {} kullanarak bir nesne (veya sözlük) oluşturun. Örneğin:

Kod Düzenleyici (JavaScript)

// Use curly brackets {} to make a dictionary of key:value pairs.
var object = {
  foo: 'bar',
  baz: 13,
  stuff: ['this', 'that', 'the other thing']
};
print('Dictionary:', object);
// Access dictionary items using square brackets.
print('Print foo:', object['foo']);
// Access dictionary items using dot notation.
print('Print stuff:', object.stuff);

Anahtarı sağlayarak sözlükten bir değer alabileceğinizi unutmayın. Bu örnekte, JavaScript nesneleri için bunu nasıl yapacağınız gösterilmektedir. Earth Engine sunucusundaki sözlükler için bu işlemin nasıl yapılacağını daha sonra öğreneceksiniz.

İşlevler

İşlevler, işlem gruplarını gruplandırarak kodun okunabilirliğini ve yeniden kullanılabilirliğini artırmanın başka bir yoludur. function anahtar kelimesiyle bir işlev tanımlayın. İşlev adları bir harfle başlar ve sonunda bir çift parantez bulunur. İşlevler genellikle işleve ne yapacağını söyleyen parametreler alır. Bu parametreler parantez içine () yazılır. İşlevi oluşturan ifadeler kümesi, süslü parantezlerin içine yazılır. return anahtar kelimesi, işlev çıkışının ne olduğunu gösterir. Bir işlevi bildirmenin birkaç yolu vardır ancak burada şuna benzer bir şey kullanacağız:

Kod Düzenleyici (JavaScript)

var myFunction = function(parameter1, parameter2, parameter3) {
  statement;
  statement;
  statement;
  return statement;
};

Satırları tek tek inceleyelim. İlk satır yeni bir işlev oluşturur ve bunu myFunction değişkenine atar. Bu değişkene herhangi bir ad verilebilirdi. İşlevin daha sonra nasıl çağrılacağını tanımlar. İşlev adından sonra parantez içinde yer alan terimler (ör.parametre1, parametre2, parametre3) parametre adlarıdır ve herhangi bir şekilde adlandırılabilir. Ancak bunlara işlevin dışındaki koddan farklı benzersiz adlar vermek iyi bir uygulamadır. Adları ne olursa olsun, işlev çağrıldığında işleve aktarılan değerlere atıfta bulunmak için bu adlar kullanılır. Bir parametrenin bir işleve aktarıldıktan sonraki değerine bağımsız değişken denir. İşlevler, işlev dışında tanımlanan değişkenleri (global değişkenler) kullanabilse de işlev bağımsız değişkenleri işlev dışında görünmez. İşlevler, ihtiyaç duyduğunuz sayıda parametre alabilir, hatta hiç parametre almayabilir. Aşağıda, yalnızca bağımsız değişkenini döndüren bir işlevin basit bir örneği verilmiştir:

Kod Düzenleyici (JavaScript)

// The reflect function takes a single parameter: element.
var reflect = function(element) {
  // Return the argument.
  return element;
};
print('A good day to you!', reflect('Back at you!'));

Bu, kullanıcı tanımlı bir işlev örneğidir. Ayrıca birçok yerleşik Earth Engine işlevi de vardır. Bu yerleşik işlevler hakkında bilgi edinmek için Kod Düzenleyici'nin Docs sekmesini inceleyin. Aşağıda, Earth Engine işlevinin çok basit bir örneği verilmiştir:

Kod Düzenleyici (JavaScript)

var aString = ee.Algorithms.String(42);

Sonraki bölümde Earth Engine nesneleri ve yöntemleri hakkında daha fazla bilgi edineceksiniz.