ข้อมูลเบื้องต้นเกี่ยวกับ JavaScript สําหรับ Earth Engine

บทแนะนำนี้ครอบคลุม JavaScript เพียงพอที่จะช่วยให้คุณเริ่มเขียนสคริปต์ Earth Engine ได้ ดูบทแนะนำ JavaScript ที่ละเอียดมากขึ้นได้ที่แหล่งข้อมูลสำหรับนักพัฒนาซอฟต์แวร์ของ Mozilla หากต้องการดูข้อมูลเบื้องต้นเกี่ยวกับการเขียนโปรแกรมพร้อมตัวอย่างใน JavaScript โปรดดู Eloquent JavaScript ดูคำแนะนำ เกี่ยวกับรูปแบบการเขียนโค้ด JavaScript ได้ที่ คู่มือรูปแบบ JavaScript ของ Google ในบทแนะนำนี้ คุณจะได้เขียน JavaScript ใน Code Editor ของ Earth Engine ก่อนเริ่มต้น โปรดใช้คู่มือเครื่องมือแก้ไขโค้ดเพื่อทำความคุ้นเคย กับสภาพแวดล้อมของเครื่องมือแก้ไขโค้ด

Hello World!

ได้เวลาเขียน JavaScript แรกสำหรับ Earth Engine แล้ว ในเบราว์เซอร์ Chrome ให้ไปที่ code.earthengine.google.com แล้วคัดลอก ข้อความต่อไปนี้ลงในตัวแก้ไขโค้ด

โปรแกรมแก้ไขโค้ด (JavaScript)

print('Hello World!');

คลิกเรียกใช้ แล้วสังเกตว่าข้อความ "Hello world!" จะพิมพ์ใน แท็บคอนโซล บรรทัดด้านบนคือคำสั่ง JavaScript ใน JavaScript คำสั่งจะลงท้ายด้วยเครื่องหมายอัฒภาค โปรแกรม Earth Engine ประกอบด้วยชุดคำสั่งเช่นคำสั่งนี้ คุณป้องกันไม่ให้โค้ดทำงานได้โดยไม่ต้องลบออกด้วยการแสดงความคิดเห็น วิธีหนึ่งในการแสดงความคิดเห็นในโค้ดคือการใส่เครื่องหมายทับ 2 อัน//ก่อนโค้ดที่คุณไม่ต้องการเรียกใช้ เช่น

โปรแกรมแก้ไขโค้ด (JavaScript)

// print('Hello World!');

แนวทางปฏิบัติแนะนำคือการใส่ความคิดเห็นจำนวนมากในโค้ดเพื่ออธิบายสิ่งที่คุณพยายาม ทำ นอกจากนี้ คุณควรลบโค้ดที่แสดงความคิดเห็นซึ่งไม่ได้ทำอะไรอีกต่อไป แนวทางปฏิบัติทั้ง 2 อย่างนี้จะช่วยปรับปรุงความสามารถในการอ่านโค้ด

ประเภทข้อมูล JavaScript พื้นฐาน

สตริง

การใช้ตัวแปรเพื่อจัดเก็บออบเจ็กต์และองค์ประกอบพื้นฐานจะช่วยให้อ่านโค้ดได้ง่ายขึ้น เช่น ตัวแปรที่จัดเก็บออบเจ็กต์สตริงจะกำหนดโดยเครื่องหมายคำพูดเดี่ยว ' หรือคู่ " (แต่ห้ามใช้ปนกัน) โดยมีเครื่องหมายคำพูดเดี่ยว เป็นค่าที่ต้องการ สร้างสตริงใหม่และจัดเก็บไว้ในตัวแปรชื่อ greetString:

โปรแกรมแก้ไขโค้ด (JavaScript)

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

Numbers

โปรดทราบว่าตัวแปรจะกำหนดด้วยคีย์เวิร์ด var ตัวแปรยัง จัดเก็บตัวเลขได้ด้วย

โปรแกรมแก้ไขโค้ด (JavaScript)

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

ในตัวอย่างนี้ สังเกตว่าเมื่อ print() ได้รับอาร์กิวเมนต์ 2 รายการที่คั่นด้วย คอมมา ระบบจะพิมพ์อาร์กิวเมนต์แต่ละรายการในบรรทัดที่ต่างกัน

รายการ

กำหนดรายการด้วยวงเล็บเหลี่ยม [] รายการตัวเลข เช่น

โปรแกรมแก้ไขโค้ด (JavaScript)

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

นอกจากนี้ รายการยังจัดเก็บสตริงหรือออบเจ็กต์อื่นๆ ได้ด้วย เช่น

โปรแกรมแก้ไขโค้ด (JavaScript)

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

วัตถุ

ออบเจ็กต์ใน JavaScript คือพจนานุกรมของคู่ key: value สร้างออบเจ็กต์ (หรือพจนานุกรม) โดยใช้เครื่องหมายปีกกา {} เช่น

โปรแกรมแก้ไขโค้ด (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);

โปรดทราบว่าคุณรับค่าจากพจนานุกรมได้โดยระบุคีย์ ตัวอย่างนี้ แสดงวิธีดำเนินการดังกล่าวกับออบเจ็กต์ JavaScript ในภายหลัง คุณจะได้เรียนรู้วิธีดำเนินการนี้สำหรับ พจนานุกรมที่อยู่ในเซิร์ฟเวอร์ Earth Engine

ฟังก์ชัน

ฟังก์ชันเป็นอีกวิธีหนึ่งในการปรับปรุงความสามารถในการอ่านและการนำโค้ดกลับมาใช้ใหม่โดยการจัดกลุ่มชุด ของการดำเนินการ กำหนดฟังก์ชันด้วยคีย์เวิร์ด function ชื่อฟังก์ชัน ขึ้นต้นด้วยตัวอักษรและมีวงเล็บคู่ที่ท้ายชื่อ ฟังก์ชันมักใช้พารามิเตอร์ซึ่งจะบอกฟังก์ชันว่าต้องทำอะไร โดยพารามิเตอร์เหล่านี้จะอยู่ในวงเล็บ () ชุดคำสั่งที่ประกอบกันเป็นฟังก์ชันจะอยู่ภายในวงเล็บปีกกา return คีย์เวิร์ดระบุเอาต์พุตของฟังก์ชัน มีหลายวิธีในการประกาศฟังก์ชัน แต่ในที่นี้เราจะใช้รูปแบบต่อไปนี้

โปรแกรมแก้ไขโค้ด (JavaScript)

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

มาดูแต่ละบรรทัดกัน บรรทัดแรกจะสร้างฟังก์ชันใหม่และกำหนด ให้กับตัวแปร myFunction ตัวแปรนี้อาจมีชื่อเป็นอะไรก็ได้ ซึ่งจะกำหนดวิธีเรียกใช้ฟังก์ชันในภายหลัง คำในวงเล็บหลังชื่อฟังก์ชัน (เช่น พารามิเตอร์ 1, พารามิเตอร์ 2, พารามิเตอร์ 3) คือชื่อพารามิเตอร์ และอาจตั้งชื่อเป็นอย่างอื่นก็ได้ แต่ควรตั้งชื่อที่ไม่ซ้ำกันซึ่งแตกต่างจากโค้ดภายนอกฟังก์ชัน ไม่ว่าคุณจะตั้งชื่อตัวแปรอย่างไร ชื่อเหล่านี้คือชื่อที่ฟังก์ชันจะใช้เพื่ออ้างอิงถึงค่าที่ส่งไปยังฟังก์ชันเมื่อมีการเรียกใช้ ค่าของพารามิเตอร์เมื่อส่งไปยังฟังก์ชันแล้วจะเรียกว่าอาร์กิวเมนต์ แม้ว่าฟังก์ชันจะใช้ตัวแปรที่ประกาศไว้นอกฟังก์ชัน (ตัวแปรส่วนกลาง) ได้ แต่อาร์กิวเมนต์ของฟังก์ชันจะมองไม่เห็นนอกฟังก์ชัน ฟังก์ชันสามารถใช้พารามิเตอร์ได้มากเท่าที่ต้องการ แม้ว่าจะไม่มีเลยก็ตาม ต่อไปนี้เป็นตัวอย่างฟังก์ชันอย่างง่ายที่แสดงผลอาร์กิวเมนต์ของตัวเอง

โปรแกรมแก้ไขโค้ด (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!'));

นี่คือตัวอย่างฟังก์ชันที่ผู้ใช้กำหนด นอกจากนี้ยังมีฟังก์ชัน Earth Engine ในตัวอีกมากมาย สำรวจแท็บเอกสารในโปรแกรมแก้ไขโค้ดเพื่อดูข้อมูลเกี่ยวกับฟังก์ชันในตัวเหล่านี้ ต่อไปนี้เป็นตัวอย่างฟังก์ชัน Earth Engine แบบง่ายๆ

โปรแกรมแก้ไขโค้ด (JavaScript)

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

ในส่วนถัดไป คุณจะได้ดูข้อมูลเพิ่มเติมเกี่ยวกับออบเจ็กต์และเมธอดของ Earth Engine