Earth Engine için JavaScript'e Giriş

Bu eğitimde, Earth Engine komut dosyaları yazmaya başlamanız için yeterli miktarda JavaScript bilgisi verilmektedir. Daha kapsamlı JavaScript eğitimleri için Mozilla'nın 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 Kılavuzu'na bakın. Bu eğitimde, Earth Engine Code Editor'da JavaScript yazacaksınız. Başlamadan önce kod düzenleyici kılavuzunu kullanarak kod düzenleyici ortamına aşina olun.

Merhaba Dünya!

Earth Engine için ilk JavaScript kodunuzu yazma zamanı! Chrome tarayıcınızda code.earthengine.google.com adresine gidin ve aşağıdakileri Code Editor'a (Kod Düzenleyici) kopyalayın:

Kod Düzenleyici (JavaScript)

print('Hello World!');

Çalıştır'ı tıklayın ve "Hello world!" ifadesinin Konsol 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ı, bu örnekteki gibi bir dizi ifadeden oluşur. Kodu silmeden çalışmasını önlemek için kodu yorum satırı haline getirebilirsiniz. Kodu yorum satırı haline getirmenin yollarından biri, çalıştırılmasını istemediğiniz kodun önüne iki eğik çizgi // koymaktır. Örneğin:

Kod Düzenleyici (JavaScript)

// print('Hello World!');

Ne yapmaya çalıştığınızı açıklamak için kodunuza çok sayıda yorum eklemek iyi bir uygulamadır. Ayrıca, artık hiçbir işe yaramayan yorumlanmış kodları silmek de iyi bir uygulamadır. Bu uygulamaların ikisi de kodun okunabilirliğini artırır.

Temel JavaScript veri türleri

Yaylı çalgılar

Nesneleri ve temel öğeleri depolamak için değişkenleri kullanmak, 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). 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 saklayabilir:

Kod Düzenleyici (JavaScript)

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

Bu örnekte, print() işlevine virgülle ayrılmış iki bağımsız değişken verildiğinde her bağımsız değişkenin farklı bir satırda yazdırıldığını gözlemleyin.

Listeler

Listeleri köşeli parantezlerle [] tanımlayın. Numara 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 saklayabilir. Ö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 çiftlerinin sözlükleridir. Küme parantezlerini {} 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 değer alabileceğinizi unutmayın. Bu örnekte, JavaScript nesneleri için bunu nasıl yapacağınız gösterilmektedir. Daha sonra, Earth Engine sunucusundaki sözlükler için bu işlemi nasıl yapacağınızı öğreneceksiniz.

İşlevler

İşlevler, işlem kümelerini gruplandırarak kodun okunabilirliğini ve yeniden kullanılabilirliğini artırmanın bir başka yoludur. function anahtar kelimesiyle bir işlev tanımlayın. İşlev adları harfle başlar ve sonunda bir çift parantez bulunur. İşlevler genellikle, işlevin ne yapması gerektiğini belirten parametreler alır. Bu parametreler parantezlerin () içine yerleştirilir. İşlevi oluşturan ifadeler kümesi küme parantezleri içine alınır. return anahtar kelimesi, işlev çıkışının ne olduğunu gösterir. İşlevleri bildirmenin çeşitli yolları vardır ancak burada şuna benzer bir yöntem kullanacağız:

Kod Düzenleyici (JavaScript)

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

Satırları tek tek inceleyelim. İlk satırda yeni bir işlev oluşturulur ve bu işlev myFunction değişkenine atanır. Bu değişken herhangi bir adla adlandırılmış olabilir. İşlevin daha sonra nasıl çağrılacağını tanımlar. İşlev adından sonraki parantezlerdeki terimler (ör.parametre1, parametre2, parametre3) parametre adlarıdır ve bunlara herhangi bir ad verilebilirdi. Ancak işlevin dışındaki koddan farklı benzersiz adlar vermek iyi bir uygulamadır. Bunlara ne ad verirseniz verin, işlev çağrıldığında işleve iletilen değerlere başvurmak için bu adları kullanır. Bir işleve geçirildikten sonra parametrenin değeri bağımsız değişken olarak adlandırılır. İşlevler, işlevin dışında tanımlanan değişkenleri (global değişkenler) kullanabilse de işlev bağımsız değişkenleri işlevin dışında görünmez. İşlevler, ihtiyacınız olan sayıda parametre alabilir (sıfır parametre de dahil). 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, çok sayıda yerleşik Earth Engine işlevi de vardır. Bu yerleşik işlevler hakkında bilgi edinmek için Kod Düzenleyici Belgeler sekmesini inceleyin. Aşağıda çok basit bir Earth Engine işlevi ö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 edinin.