ตัวแก้ไขโค้ด Earth Engine

เครื่องมือแก้ไขโค้ด Earth Engine (EE) ที่ code.earthengine.google.com เป็น IDE บนเว็บสําหรับ Earth Engine JavaScript API ฟีเจอร์เครื่องมือแก้ไขโค้ดออกแบบมาเพื่อพัฒนาเวิร์กโฟลว์เชิงพื้นที่ที่ซับซ้อนได้อย่างรวดเร็วและง่ายดาย เครื่องมือแก้ไขโค้ดมีองค์ประกอบต่อไปนี้ (แสดงในรูปที่ 1)

  • ตัวแก้ไขโค้ด JavaScript
  • การแสดงแผนที่เพื่อแสดงภาพชุดข้อมูลเชิงพื้นที่
  • เอกสารอ้างอิง API (แท็บเอกสาร)
  • เครื่องมือจัดการสคริปต์ที่ใช้ Git (แท็บสคริปต์)
  • เอาต์พุตคอนโซล (แท็บคอนโซล)
  • ตัวจัดการงาน (แท็บงาน) เพื่อจัดการการค้นหาที่ใช้เวลานาน
  • การค้นหาแผนที่แบบอินเทอร์แอกทีฟ (แท็บเครื่องมือตรวจสอบ)
  • ค้นหาที่เก็บถาวรของข้อมูลหรือสคริปต์ที่บันทึกไว้
  • เครื่องมือวาดรูปเรขาคณิต

คอมโพเนนต์ของตัวแก้ไขโค้ด

รูปที่ 1 แผนภาพองค์ประกอบของเครื่องมือแก้ไขโค้ด Earth Engine ที่ code.earthengine.google.com

ตัวแก้ไขโค้ดมีฟีเจอร์มากมายที่จะช่วยให้คุณใช้ประโยชน์จาก Earth Engine API ได้ ดูตัวอย่างสคริปต์หรือบันทึกสคริปต์ของคุณเองในแท็บสคริปต์ ค้นหาวัตถุที่วางไว้ในแผนที่ด้วยแท็บเครื่องมือตรวจสอบ แสดงผลลัพธ์ที่เป็นตัวเลขและแผนภูมิโดยใช้ Google Visualization API แชร์ URL ที่ไม่ซ้ำกันไปยังสคริปต์กับผู้ทำงานร่วมกันและเพื่อนด้วยปุ่มรับลิงก์ ระบบจะส่งสคริปต์ที่คุณพัฒนาในเครื่องมือแก้ไขโค้ดไปยัง Google เพื่อประมวลผล และส่งกลับไปแสดงในแท็บแผนที่และ/หรือคอนโซล สิ่งที่คุณต้องใช้เพื่อเรียกใช้เครื่องมือแก้ไขโค้ดมีเพียงเว็บเบราว์เซอร์ (ใช้ Google Chrome เพื่อให้ได้ผลลัพธ์ที่ดีที่สุด) และการเชื่อมต่ออินเทอร์เน็ต ส่วนต่อไปนี้อธิบายองค์ประกอบของเครื่องมือแก้ไขโค้ด Earth Engine โดยละเอียด

เครื่องมือแก้ไข JavaScript

เครื่องมือแก้ไข JavaScript จะทําสิ่งต่อไปนี้

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

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

เอกสารอ้างอิง API (แท็บเอกสาร)

ทางด้านซ้ายของเครื่องมือแก้ไขโค้ดคือแท็บเอกสารประกอบซึ่งมีเอกสารประกอบ JavaScript API ที่สมบูรณ์ คุณสามารถค้นหาและเรียกดูเอกสารประกอบได้จากแท็บเอกสาร

เครื่องมือจัดการสคริปต์ (แท็บสคริปต์)

แท็บสคริปต์อยู่ข้างเอกสารประกอบ API ในแผงด้านซ้ายของตัวแก้ไขโค้ด ตัวจัดการสคริปต์จะจัดเก็บสคริปต์ส่วนตัว สคริปต์ที่แชร์ และสคริปต์ตัวอย่างในที่เก็บ Git ที่ Google โฮสต์ ระบบจะจัดเรียงที่เก็บตามระดับการเข้าถึง โดยสคริปต์ส่วนตัวจะจัดเก็บไว้ในที่เก็บที่คุณเป็นเจ้าของในโฟลเดอร์เจ้าของ: users/username/default คุณ (และคุณเท่านั้น) ที่จะเข้าถึงที่เก็บข้อมูลในโฟลเดอร์เจ้าของได้ เว้นแต่คุณจะแชร์กับบุคคลอื่น พื้นที่เก็บข้อมูลในโฟลเดอร์ Writer คือพื้นที่เก็บข้อมูลที่เจ้าของได้ให้สิทธิ์การเขียนแก่คุณ คุณสามารถเพิ่มสคริปต์ใหม่ แก้ไขสคริปต์ที่มีอยู่ หรือเปลี่ยนสิทธิ์เข้าถึง (คุณไม่สามารถนำเจ้าของออกได้) ของที่เก็บในโฟลเดอร์ Writer ที่เก็บในโฟลเดอร์ผู้อ่านคือที่เก็บที่เจ้าของให้สิทธิ์การอ่านแก่คุณ โฟลเดอร์ Examples เป็นพื้นที่เก็บข้อมูลพิเศษที่ Google จัดการซึ่งมีตัวอย่างโค้ด โฟลเดอร์ที่เก็บถาวรประกอบด้วยที่เก็บข้อมูลเดิมที่คุณมีสิทธิ์เข้าถึง แต่เจ้าของยังไม่ได้ย้ายข้อมูลจากเครื่องมือจัดการสคริปต์เวอร์ชันเก่า ค้นหาสคริปต์โดยใช้แถบตัวกรองที่ด้านบนของแท็บสคริปต์

เครื่องมือจัดการสคริปต์

รูปที่ 2 เครื่องมือจัดการสคริปต์

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

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

คุณเข้าถึงที่เก็บได้โดยใช้ Git เพื่อให้จัดการและแก้ไขสคริปต์นอกเครื่องมือแก้ไขโค้ด หรือซิงค์กับระบบภายนอก เช่น GitHub ได้ (ดูข้อมูลเพิ่มเติมเกี่ยวกับ Git จากบทแนะนำนี้) คลิกไอคอน ข้างชื่อที่เก็บข้อมูลเพื่อดูวิธีการโคลนที่เก็บข้อมูล โปรดทราบว่าคุณสามารถเรียกดูที่เก็บข้อมูลที่เข้าถึงได้โดยไปที่ earthengine.googlesource.com สำหรับการดำเนินการบางอย่างของ Git คุณอาจต้องสร้างข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์โดยไปที่ลิงก์ "สร้างรหัสผ่าน" ที่ด้านบนของหน้า earthengine.googlesource.com

โมดูลสคริปต์

คุณควรเขียนโค้ดแบบโมดูลที่นํากลับมาใช้ซ้ำได้ ซึ่งแชร์ระหว่างสคริปต์ได้โดยไม่ต้องคัดลอกและวางมากนัก Earth Engine ช่วยให้แชร์โค้ดระหว่างสคริปต์ได้ เพื่อเปิดใช้การพัฒนาแบบโมดูล เช่น สมมติว่าคุณเขียนฟังก์ชันที่ดำเนินการชุดการดำเนินการที่มีประโยชน์ แทนที่จะคัดลอกโค้ดของฟังก์ชันลงในสคริปต์ใหม่ สคริปต์ใหม่จะโหลดฟังก์ชันโดยตรงได้ง่ายกว่า หากต้องการให้สคริปต์อื่นๆ ใช้ฟังก์ชันหรือออบเจ็กต์ได้ ให้เพิ่มฟังก์ชันหรือออบเจ็กต์นั้นลงในออบเจ็กต์พิเศษที่เรียกว่า exports หากต้องการใช้โค้ดในสคริปต์อื่น ให้ใช้ฟังก์ชัน require เพื่อโหลดการส่งออกจากสคริปต์อื่น ตัวอย่างเช่น สมมติว่าคุณกําหนดข้อบังคับต่อไปนี้ในไฟล์ชื่อ FooModule.js ซึ่งอยู่ในโฟลเดอร์ชื่อ Modules

/**
 * The Foo module is a demonstration of script modules.
 * It contains a foo function that returns a greeting string.
 * It also contains a bar object representing the current date.
 * @module Modules/FooModule
 */

/**
 * Returns a greeting string.
 * @param {ee.String} arg The name to which the greeting should be addressed
 * @return {ee.String} The complete greeting.
 */
exports.foo = function(arg) {
  return 'Hello, ' + arg + '!  And a good day to you!';
};

/**
 * An ee.Date object containing the time at which the object was created.
 */
exports.bar = ee.Date(Date.now());

โปรดสังเกตการใช้คีย์เวิร์ด exports ในรูปแบบ exports.objectToExport คุณสามารถใช้โมดูลนี้ในสคริปต์อื่นได้โดยใช้ฟังก์ชัน require เช่น

var Foo = require('users/username/default:Modules/FooModule.js');

print(Foo.doc);

print(Foo.foo('world'));

print('Time now:', Foo.bar);

ฟังก์ชัน require ต้องการสตริงที่อธิบายเส้นทางสัมบูรณ์ไปยังตำแหน่งของโมดูล กล่าวโดยละเอียดคือ อาร์กิวเมนต์ของ require() อยู่ในรูปแบบ 'pathToRepository:pathToModuleScript' คุณจะโหลดได้เฉพาะโมดูลจากที่เก็บที่คุณเป็นเจ้าของและ/หรือมีสิทธิ์เข้าถึงระดับอ่าน หากต้องการให้ผู้อื่นใช้โมดูลได้ คุณต้องแชร์ที่เก็บกับผู้ใช้รายอื่นที่ต้องการให้เข้าถึง คุณอาจต้องจัดทำเอกสารประกอบของโมดูลเพื่อช่วยให้ผู้ใช้ได้เข้าใจวิธีใช้ เราขอแนะนำให้ใช้รูปแบบ JSDoc ด้วยแท็ก @module

คุณสามารถใช้พารามิเตอร์ของ URL ?scriptPath={repo}:{script} เพื่อแชร์การอ้างอิงไฟล์ในรีโปได้ เช่น https://code.earthengine.google.com/?scriptPath=users/username/utils:utils เมื่อเข้าชม URL ระบบจะเพิ่มไฟล์ที่อ้างอิงและที่เก็บข้อมูลของไฟล์นั้นลงในไดเรกทอรี Reader หรือ Writer ในแท็บสคริปต์ ทั้งนี้ขึ้นอยู่กับระดับสิทธิ์ของคุณสำหรับที่เก็บข้อมูลที่แชร์

เครื่องมือจัดการเนื้อหา (แท็บเนื้อหา)

เครื่องมือจัดการชิ้นงานอยู่ในแท็บชิ้นงานในแผงด้านซ้าย ใช้เครื่องมือจัดการชิ้นงาน (รูปที่ 3) เพื่ออัปโหลดและจัดการชิ้นงานรูปภาพของคุณเองใน Earth Engine ดูรายละเอียดได้ในหน้าเครื่องมือจัดการเนื้อหา

เครื่องมือจัดการเนื้อหา

รูปที่ 3 เครื่องมือจัดการเนื้อหา

คุณแชร์สคริปต์ของเครื่องมือแก้ไขโค้ดได้ผ่าน URL ที่เข้ารหัส ส่วนต่อไปนี้อธิบายวิธีต่างๆ ในการสร้าง URL สคริปต์ ตัวเลือกที่ใช้ได้ และวิธีการจัดการ URL สคริปต์

ปุ่ม "รับลิงก์" ที่ด้านบนของเครื่องมือแก้ไขโค้ด (รูปที่ 4) มีอินเทอร์เฟซสำหรับสร้าง URL ของสคริปต์และตั้งค่าตัวเลือกลักษณะการทํางานของสคริปต์ โปรดดูความแตกต่างระหว่าง URL ของภาพรวมกับ URL ของสคริปต์ที่บันทึกไว้ที่อธิบายไว้ด้านล่าง

หน้า

รูปที่ 4 ปุ่ม "รับลิงก์"

คุณสามารถแชร์โค้ดในเครื่องมือแก้ไขผ่าน URL สแนปชอตที่เข้ารหัสซึ่งสร้างขึ้นเมื่อคลิกปุ่ม "รับลิงก์" ที่ด้านบนของเครื่องมือแก้ไขโค้ด เมื่อมีผู้ที่มีบัญชี Earth Engine เข้าชม URL เบราว์เซอร์จะไปยังเครื่องมือแก้ไขโค้ดและจำลองสภาพแวดล้อมให้เหมือนกับตอนที่สร้างลิงก์ ซึ่งรวมถึงโค้ด การนำเข้า เลเยอร์แผนที่ และตำแหน่งแผนที่ การคลิกปุ่ม "รับลิงก์" จะคัดลอกลิงก์สคริปต์ไปยังคลิปบอร์ดโดยอัตโนมัติ นอกจากนี้ กล่องโต้ตอบจะปรากฏขึ้นพร้อมตัวเลือกในการควบคุมการเรียกใช้สคริปต์ที่แชร์ รวมถึงปุ่มสำหรับคัดลอกและไปที่ลิงก์ที่สร้างขึ้น ตัวเลือกการควบคุม ได้แก่ การป้องกันไม่ให้สคริปต์ทำงานโดยอัตโนมัติ และซ่อนแผงโค้ดเมื่อมีคนเปิดลิงก์ที่แชร์ คุณปิดกล่องโต้ตอบที่ลากได้ผ่านแป้น "Esc" หรือคลิกที่อื่นในหน้า

สคริปต์ที่บันทึกไว้จะมีตัวเลือกในการแชร์ลิงก์ที่จะโหลดเวอร์ชันที่บันทึกล่าสุดเสมอ และจะมีเพียงคุณและคนอื่นๆ ที่มีสิทธิ์เข้าถึงที่เก็บซึ่งมีสคริปต์ดังกล่าวเท่านั้นที่เข้าถึงได้ หากต้องการใช้ฟีเจอร์นี้ ให้โหลดสคริปต์ที่บันทึกไว้จากแท็บเครื่องมือจัดการสคริปต์ คลิกลูกศรแบบเลื่อนลงทางด้านขวาของปุ่ม "รับลิงก์" แล้วเลือก "คัดลอกเส้นทางสคริปต์" กล่องโต้ตอบจะปรากฏขึ้นพร้อมแสดง URL สคริปต์ที่แชร์ได้ โปรดทราบว่าระบบได้ตั้งค่า URL สคริปต์ในแถบที่อยู่ของเบราว์เซอร์ด้วย ดูคําแนะนําเกี่ยวกับการแชร์ที่เก็บกับผู้อื่นได้ที่ส่วนเครื่องมือจัดการสคริปต์

ปุ่มแบบเลื่อนลงทางด้านขวาของปุ่ม "รับลิงก์" มีตัวเลือกในการ "จัดการลิงก์" การคลิกตัวเลือกนี้จะโหลดแท็บเบราว์เซอร์ใหม่ที่มีอินเทอร์เฟซให้คุณเรียกดู นำออก และดาวน์โหลดลิงก์สคริปต์ที่สร้างไว้ก่อนหน้านี้ การเลือกสคริปต์และกดปุ่มดาวน์โหลดจะเป็นการดาวน์โหลดโฟลเดอร์ที่บีบอัด ("code_editor_links.zip") ลงในระบบของคุณ ซึ่งมีการแสดงไฟล์ .txt สําหรับสคริปต์แต่ละรายการที่เลือก

โมดูล ui.url ช่วยให้สามารถจัดการตัวระบุข้อมูลโค้ดของ URL สคริปต์แบบเป็นโปรแกรมได้ผ่านเมธอด get และ set ซึ่งหมายความว่าสคริปต์ในเครื่องมือแก้ไขโค้ดและแอป Earth Engine จะอ่านและจัดเก็บค่าใน URL ของหน้าเว็บได้ สังเกตที่ส่วนท้ายของ URL 2 รายการต่อไปนี้ URL แรกตั้งค่าตัวแปร debug เป็น false และ URL ที่ 2 ตั้งค่าเป็น true ไปที่ทั้ง 2 ลิงก์และสังเกตว่าช่องทําเครื่องหมายแก้ไขข้อบกพร่องในคอนโซลไม่ได้เลือกใน URL แรก แต่เลือกใน URL ที่ 2 ซึ่งจะเปลี่ยนลักษณะการทํางานของสคริปต์แต่ละรายการ

https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=false;
https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=true;

ฟีเจอร์นี้ใช้เพื่อตั้งค่าการซูมและจัดกึ่งกลางแผนที่ รวมถึงลักษณะการทำงานอื่นๆ ที่คุณอาจต้องการปรับแต่งเมื่อส่งลิงก์ไปยังบุคคลหรือกลุ่มที่ต้องการได้

เครื่องมือค้นหา

หากต้องการค้นหาชุดข้อมูลที่จะใช้ในสคริปต์ คุณสามารถใช้เครื่องมือค้นหาสำหรับที่เก็บถาวรของข้อมูล เครื่องมือค้นหาคือกล่องข้อความที่ด้านบนของเครื่องมือแก้ไขโค้ดซึ่งระบุว่า "ค้นหาสถานที่และชุดข้อมูล..." พิมพ์ชื่อผลิตภัณฑ์ข้อมูล เซ็นเซอร์ หรือคีย์เวิร์ดอื่นๆ ในแถบค้นหา แล้วคลิกปุ่ม เพื่อดูรายการสถานที่ ข้อมูลตาราง และข้อมูลแรสเตอร์ที่ตรงกัน คลิกผลลัพธ์แบบแรสเตอร์หรือตารางเพื่อดูคำอธิบายชุดข้อมูลนั้นในที่เก็บถาวร หากต้องการนําเข้าชุดข้อมูลลงในสคริปต์โดยตรง ให้คลิกลิงก์importหรือปุ่ม จากคําอธิบายชุดข้อมูล

การนำเข้า

ผลลัพธ์ของการนําเข้าชุดข้อมูลลงในสคริปต์จะจัดระเบียบในส่วนการนําเข้าที่ด้านบนของสคริปต์ ซึ่งจะซ่อนอยู่จนกว่าคุณจะนําเข้าข้อมูล เมื่อสร้างการนําเข้าแล้ว คุณควรเห็นข้อมูลคล้ายกับในรูปที่ 5 หากต้องการคัดลอกการนําเข้าไปยังสคริปต์อื่น หรือแปลงการนําเข้าเป็น JavaScript ให้คลิกไอคอน ข้างส่วนหัวการนําเข้า แล้วคัดลอกโค้ดที่สร้างขึ้นไปยังสคริปต์ คุณลบการนําเข้าได้ด้วยไอคอน

ส่วนการนําเข้าของตัวแก้ไขโค้ด

รูปที่ 5 ส่วนการนําเข้าที่ด้านบนของตัวแก้ไขโค้ด

แผนที่

ออบเจ็กต์แผนที่ใน API หมายถึงการแสดงแผนที่ในตัวแก้ไขโค้ด เช่น Map.getBounds() จะแสดงภูมิภาคทางภูมิศาสตร์ที่มองเห็นได้ในเครื่องมือแก้ไขโค้ด ตรวจสอบฟังก์ชัน Map ใน API เพื่อดูการปรับแต่งอื่นๆ สำหรับการแสดงผลนี้

เครื่องมือจัดการเลเยอร์

ใช้เครื่องมือจัดการเลเยอร์ที่มุมขวาบนของแผนที่เพื่อปรับการแสดงเลเยอร์ที่คุณเพิ่มลงในแผนที่ กล่าวโดยละเอียดคือ คุณสามารถสลับการแสดงผลของเลเยอร์หรือปรับความโปร่งใสของเลเยอร์ด้วยแถบเลื่อน คลิกไอคอน เพื่อปรับพารามิเตอร์การแสดงภาพสำหรับเลเยอร์แต่ละรายการ เครื่องมือแสดงภาพปรากฏขึ้น (รูปที่ 6) ซึ่งช่วยให้คุณกําหนดค่าพารามิเตอร์การแสดงเลเยอร์แบบอินเทอร์แอกทีฟได้ คลิกปุ่มทางด้านขวาของเครื่องมือ (ซึ่งจะทำการยืดแบบกำหนดเองตามช่วงต่ำสุดและสูงสุดที่ระบุโดยค่าเริ่มต้น) เพื่อยืดการแสดงผลเป็นเปอร์เซ็นต์ไทล์หรือค่าความเบี่ยงเบนมาตรฐานของค่ารูปภาพในหน้าต่างแสดงผล ระบบจะคํานวณสถิติจากพิกเซลทั้งหมดในหน้าต่างแผนที่ที่ระดับการซูมปัจจุบัน ใช้แถบเลื่อนเพื่อปรับแกมมาและ/หรือความโปร่งใส คลิกปุ่มตัวเลือกชุดสี แล้วระบุชุดสีที่กำหนดเองโดยการเพิ่มสี () นำสีออก () หรือป้อนรายการสตริงฐาน 16 ที่คั่นด้วยคอมมาด้วยตนเอง () คลิกใช้เพื่อใช้พารามิเตอร์การแสดงภาพกับการแสดงผลปัจจุบัน คลิกนําเข้าเพื่อโหลดออบเจ็กต์พารามิเตอร์การแสดงภาพเป็นตัวแปรใหม่ในส่วนนําเข้าของสคริปต์

เครื่องมือแสดงภาพเลเยอร์

รูปที่ 6 เครื่องมือแสดงภาพเลเยอร์

แท็บเครื่องมือตรวจสอบ

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

แท็บเครื่องมือตรวจสอบ

รูปที่ 7 แท็บเครื่องมือตรวจสอบจะแสดงข้อมูลเกี่ยวกับตำแหน่งเคอร์เซอร์และค่าเลเยอร์ใต้เคอร์เซอร์

แท็บคอนโซล

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

แท็บงาน

งานที่ดำเนินการใน Earth Engine เป็นการดำเนินการที่ทำงานได้นานกว่าระยะหมดเวลาของคำขอ API มาตรฐาน งานที่มีการทำงานต่อเนื่องเหล่านี้เป็นกลไกเดียวในการสร้างอาร์ติแฟกต์ถาวรใน Earth Engine และระบบที่เกี่ยวข้อง (Google Cloud Storage, Google ไดรฟ์ ฯลฯ) และแบ่งออกเป็น 2 หมวดหมู่ ได้แก่ Import และ Export

คุณสามารถใช้การนําเข้างานเพื่ออัปโหลดรูปภาพหรืออัปโหลดตารางไปยัง Earth Engine จากไฟล์ประเภทต่างๆ (.csv, .tif ฯลฯ) คุณสามารถส่งออกงานเพื่อเรียกใช้และเขียนผลลัพธ์จากระบบการคํานวณ EE ได้ (ดูคู่มือการส่งออกข้อมูล)

สําหรับการส่งออก การเรียกใช้ฟังก์ชัน Export แต่ละครั้งในเครื่องมือแก้ไขโค้ดจะสร้างรายการในส่วนงานที่ยังไม่ได้ส่งของแท็บงาน หากต้องการส่งงานการส่งออกไปยังเซิร์ฟเวอร์ ให้คลิกปุ่มเรียกใช้ข้างงาน กล่องโต้ตอบการกําหนดค่าจะปรากฏขึ้นเพื่อให้คุณระบุพารามิเตอร์ที่หลากหลายสําหรับงาน หากระบุงานโดยสมบูรณ์ ณ เวลาสร้าง (นั่นคือการเรียก Export มีพารามิเตอร์ที่จำเป็นทั้งหมด) ให้กด ctrl หรือ ค้างไว้ขณะคลิกเรียกใช้เพื่อส่งงานโดยไม่แสดงกล่องโต้ตอบ

สำหรับการนําเข้า การอัปโหลดไฟล์จะเกิดขึ้นในเครื่องก่อนที่จะส่งงานไปยังเซิร์ฟเวอร์ งานนำเข้าในระยะการอัปโหลดจะแสดงความคืบหน้าในส่วนงานที่ยังไม่ได้ส่ง และส่งไปยังเซิร์ฟเวอร์โดยอัตโนมัติเมื่อการอัปโหลดไฟล์เสร็จสมบูรณ์

งานที่ยังไม่ได้ส่งจะปรากฏในหน้าที่สร้างงานเท่านั้น และงานจะหายไปเมื่อปิดหน้า เมื่อส่งงานไปยังเซิร์ฟเวอร์แล้ว การคลิกแถวงานใน UI จะแสดงข้อมูลเพิ่มเติมและตัวเลือกเกี่ยวกับสถานะงาน รวมถึงตัวเลือกในการขอยกเลิก

หากต้องการดูและยกเลิกงานหลายรายการในมุมมองแบบเต็มหน้า (รวมถึงในไคลเอ็นต์บนอุปกรณ์เคลื่อนที่) ให้ใช้หน้างานใน Cloud Console

เครื่องมือสร้างโปรไฟล์

เครื่องมือวิเคราะห์จะแสดงข้อมูลเกี่ยวกับทรัพยากร (เวลา CPU, หน่วยความจํา) ที่อัลกอริทึมหนึ่งๆ และส่วนอื่นๆ ของการคำนวณใช้ ซึ่งช่วยในการวินิจฉัยสาเหตุที่สคริปต์ทํางานช้าหรือไม่สําเร็จเนื่องจากขีดจํากัดของหน่วยความจํา หากต้องการใช้โปรแกรมวิเคราะห์ ให้คลิกตัวเลือกเรียกใช้ด้วยโปรแกรมวิเคราะห์ในเมนูแบบเลื่อนลงของปุ่มเรียกใช้ แป้นพิมพ์ลัดคือกด Alt (หรือ Option ใน Mac) ค้างไว้ แล้วคลิก "เรียกใช้" หรือกด Ctrl+Alt+Enter ซึ่งจะเปิดใช้งานแท็บเครื่องมือวิเคราะห์ทางด้านขวาของเครื่องมือแก้ไขโค้ด เมื่อสคริปต์ทํางาน แท็บเครื่องมือวิเคราะห์จะแสดงตารางการใช้ทรัพยากรจากสคริปต์ การคลิกปุ่มเรียกใช้ (โดยไม่ใช้เครื่องมือวิเคราะห์โปรไฟล์) จะทําให้แท็บเครื่องมือวิเคราะห์โปรไฟล์หายไปและปิดใช้เครื่องมือวิเคราะห์โปรไฟล์

ดูรายละเอียดของเอาต์พุตจากเครื่องมือวิเคราะห์โปรไฟล์ได้ที่หน้าภาพรวมการคํานวณ

เครื่องมือเรขาคณิต

นอกจากนี้ คุณยังนําเข้าเรขาคณิตไปยังสคริปต์โดยการวาดบนหน้าจอได้ด้วย หากต้องการสร้างเรขาคณิต ให้ใช้เครื่องมือวาดเรขาคณิตที่มุมซ้ายบนของการแสดงแผนที่ (รูปที่ 8) หากต้องการวาดจุด ให้ใช้ไอคอนจุดสังเกต หากต้องการวาดเส้น ให้ใช้ไอคอนเส้น หากต้องการวาดรูปหลายเหลี่ยม ให้ใช้ไอคอนรูปหลายเหลี่ยม หากต้องการวาดสี่เหลี่ยมผืนผ้า ให้ใช้ไอคอนสี่เหลี่ยมผืนผ้า (โปรดทราบว่าสี่เหลี่ยมผืนผ้าเป็นเรขาคณิตแบบระนาบ จึงวางไว้ในเลเยอร์ที่มีเรขาคณิตแบบทรงกลมไม่ได้ เช่น เส้นและรูปหลายเหลี่ยม)

การใช้เครื่องมือวาดภาพใดๆ จะสร้างเลเยอร์เรขาคณิตใหม่โดยอัตโนมัติ และเพิ่มการนําเข้าสําหรับเลเยอร์นั้นลงในส่วนการนําเข้า หากต้องการเพิ่มเรขาคณิตลงในเลเยอร์ใหม่ ให้วางเมาส์เหนือ "การนําเข้าเรขาคณิต" ในการแสดงแผนที่ แล้วคลิกลิงก์ +เลเยอร์ใหม่ นอกจากนี้ คุณยังสลับระดับการเข้าถึงเรขาคณิตจากส่วนการนําเข้าเรขาคณิตได้ด้วย โปรดทราบว่าเรขาคณิตที่วาดจะเป็นเรขาคณิตเชิงเรขาโดยค่าเริ่มต้น ยกเว้นสี่เหลี่ยมผืนผ้าซึ่งเป็นเรขาคณิตแบบระนาบเท่านั้น ใช้คอนสตรัคเตอร์เรขาคณิตเพื่อแปลงเป็นเรขาคณิตแบบระนาบ ดูข้อมูลเพิ่มเติมเกี่ยวกับเรขาคณิตใน Earth Engine ได้ในหน้าเรขาคณิต

รูปที่ 8 เครื่องมือวาดรูปเรขาคณิตอยู่ที่มุมซ้ายบนของการแสดงแผนที่

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

เครื่องมือกำหนดค่าเรขาคณิต

รูปที่ 9 เครื่องมือกำหนดค่าเรขาคณิต

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

ช่วยด้วย

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