API นี้ช่วยให้เข้าถึงข้อมูลรูปภาพเชิงพื้นที่ที่หลากหลายได้อย่างง่ายดายและสม่ำเสมอ เชิงพื้นที่หมายความว่าข้อมูลเชื่อมโยงกับสถานที่ตั้งบนพื้นผิวโลก ข้อมูลรูปภาพหมายถึงข้อมูลที่มีโครงสร้างเป็นตารางกริดแบบสม่ำเสมอของค่าพิกเซล ซึ่งคล้ายกับรูปภาพแบบเดิม
ตัวอย่างที่คุ้นเคยที่สุดของข้อมูลประเภทนี้คือภาพถ่ายจากดาวเทียม ซึ่งคล้ายกับที่ผู้ใช้คุ้นเคยใน Google Maps และ Earth อย่างไรก็ตาม ชุดข้อมูลอื่นๆ อีกมากมายมีโครงสร้างเดียวกัน ซึ่งรวมถึงชุดข้อมูลสภาพอากาศและภูมิอากาศแบบกริด ชุดข้อมูลภูมิประเทศและสิ่งปกคลุมดิน และชุดข้อมูลความหนาแน่นของประชากร เป็นต้น
การตรวจสอบสิทธิ์
Earth Engine API ใช้โปรโตคอล OAuth 2.0 สำหรับการตรวจสอบสิทธิ์และการให้สิทธิ์ มีไลบรารีที่สะดวกสำหรับการใช้ OAuth 2.0 เพื่อออกการเรียก API ในภาษาต่างๆ มากมาย หากคุณไม่เคยใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs มาก่อน คุณอาจต้องทำความคุ้นเคยกับเอกสารประกอบเกี่ยวกับการใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs
API นี้ใช้ scope https://www.googleapis.com/auth/earthengine.readonly ของ Earth Engine OAuth 2.0 หากกำหนดค่าข้อมูลเข้าสู่ระบบของบัญชีบริการด้วยตนเอง คุณจะต้องขอขอบเขตนั้นอย่างชัดเจน หากใช้ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันที่มีอยู่ในอินสแตนซ์เครื่องเสมือนของ Compute Engine คุณจะต้องกำหนดค่าอินสแตนซ์ VM เพื่อขอขอบเขตดังกล่าว
เนื้อหา
หัวใจสำคัญของโมเดลข้อมูล Earth Engine คือโครงสร้างที่คล้ายกับระบบไฟล์ของชิ้นงาน ชิ้นงานมี 3 ประเภทหลัก ซึ่งอธิบายรายละเอียดเพิ่มเติมไว้ด้านล่าง โดยข้อมูลแรสเตอร์เชิงพื้นที่เองจะจัดเก็บไว้ในรูปภาพ รูปภาพสามารถจัดกลุ่มเป็นคอลเล็กชันขนาดใหญ่ และรูปภาพและคอลเล็กชันจะจัดระเบียบเพิ่มเติมในลำดับชั้นของโฟลเดอร์
ตัวอย่างเช่น เส้นทางต่อไปนี้อธิบายรูปภาพ Landsat ที่เฉพาะเจาะจง
LANDSAT/LC8_L1T/LC81180562013193LGN00
ในตัวอย่างนี้ LANDSAT คือโฟลเดอร์ระดับบนสุดที่มีข้อมูล Landsat ทั้งหมด LC8_L1T ระบุคอลเล็กชันรูปภาพ Landsat 8 ที่ได้รับการปรับเทียบและแก้ไขภูมิประเทศแล้ว และ LC81180562013193LGN00 ระบุรูปภาพหนึ่งๆ ในคอลเล็กชันนั้น เส้นทางของชิ้นงานอาจมีตัวอักษร ตัวเลข ขีดล่าง และขีดกลาง โดยคั่นด้วยเครื่องหมายทับ
รูปภาพแต่ละรูปมีข้อมูลเมตาที่ช่วยให้ระบุข้อมูลที่สนใจได้ง่าย โดยทั่วไปแล้วพร็อพเพอร์ตี้ข้อมูลเมตาต่อรูปภาพจะมีข้อมูลต่อไปนี้
- รูปทรงเรขาคณิตของร่องรอยของรูปภาพ เช่น ขอบเขตเชิงพื้นที่ของภาพถ่ายดาวเทียมหรือชุดข้อมูลภูมิประเทศ
- การประทับเวลาของรูปภาพ เช่น เวลาที่ได้ภาพถ่ายจากดาวเทียม หรือวันหรือเดือนในชุดข้อมูลโมเดลสภาพอากาศ
- พร็อพเพอร์ตี้คีย์/ค่าที่กำหนดเอง เช่น เปอร์เซ็นต์การปกคลุมของเมฆโดยประมาณของภาพถ่ายจากดาวเทียม Landsat
พิกเซลและการฉายแผนที่
ใน Earth Engine รูปภาพแต่ละรูปประกอบด้วยแบนด์ข้อมูลอย่างน้อย 1 แบนด์ ซึ่งอาจสอดคล้องกับแถบสีแดง เขียว และน้ำเงินของภาพถ่ายจากดาวเทียม RGB ทั่วไป หรืออาจสอดคล้องกับสิ่งอื่นที่แตกต่างกันโดยสิ้นเชิง เช่น อุณหภูมิและปริมาณน้ำฝนในชุดข้อมูลสภาพอากาศ พิกเซลในแต่ละแถบมีประเภทข้อมูลที่เฉพาะเจาะจง เช่น uint8 หรือ float32
พิกเซลในตารางกริดพิกเซลจะสอดคล้องกับจุดบนพื้นผิวโลกผ่านฟังก์ชันทางคณิตศาสตร์ที่เรียกว่าการฉายแผนที่ โดยปกติแล้ว ความสัมพันธ์นี้จะมี 2 องค์ประกอบ ขั้นแรก ระบบอ้างอิงพิกัด (CRS) จะกำหนดพิกัด 2 มิติที่แสดงจุดบนพื้นผิวโค้งของโลก ระบบอ้างอิงพิกัดที่แตกต่างกันมีคุณสมบัติที่แตกต่างกันซึ่งทําให้เหมาะสําหรับการใช้กับข้อมูลประเภทต่างๆ ในแอปพลิเคชันต่างๆ โดยปกติแล้ว ระบบอ้างอิงพิกัดจะระบุโดยใช้รหัสตัวระบุมาตรฐาน ตัวอย่างที่พบบ่อย ได้แก่ พิกัดEquirectangular, Web Mercator และ UTM
จากนั้นโดยทั่วไปพิกัดของพิกเซลจะเชื่อมโยงกับระบบอ้างอิงพิกัดเชิงพื้นที่ผ่านการแปลงแบบแอฟฟินที่ควบคุมขนาดทางกายภาพและจุดเริ่มต้นของตารางกริดพิกเซล ใน Earth Engine เราจะจัดเก็บพีระมิดของข้อมูลสำหรับแต่ละรูปภาพ โดยระดับฐานของพีระมิดจะมีข้อมูลต้นฉบับในความละเอียดดั้งเดิม และระดับที่สูงกว่าของพีระมิดจะจัดเก็บข้อมูลภาพรวมที่มีความละเอียดลดลง ระดับของปิรามิดเหล่านี้อธิบายได้ด้วยการแปลงแบบแอฟฟินที่มีสเกลแตกต่างกันตามปัจจัยที่ต่อเนื่องกันของ 2
คอลเล็กชันและโฟลเดอร์
โดยทั่วไปแล้ว รูปภาพมักจะมาในคอลเล็กชันข้อมูลขนาดใหญ่ เช่น คอลเล็กชันรูปภาพทั้งหมดที่ดาวเทียมเฉพาะดวงหนึ่งถ่ายไว้ หรือคอลเล็กชันค่าประมาณอุณหภูมิโลกในช่วงเวลาต่างๆ Earth Engine สร้างดัชนีข้อมูลเมตาที่ช่วยให้คุณกรองหรือค้นหารูปภาพในคอลเล็กชันตามข้อมูลเมตา รวมถึงการกรองตามสถานที่และเวลา โดยปกติแล้ว รูปภาพทั้งหมดภายในคอลเล็กชันเดียวจะมีโครงสร้างเดียวกัน นั่นคือ แถบเดียวกันและพร็อพเพอร์ตี้ข้อมูลเมตาเดียวกัน
รูปภาพและคอลเล็กชันจะได้รับการจัดระเบียบเป็นลำดับชั้นของโฟลเดอร์ โฟลเดอร์ก็เหมือนกับโฟลเดอร์หรือไดเรกทอรีทั่วไปในระบบไฟล์แบบเดิม ซึ่งเป็นคอนเทนเนอร์อย่างง่ายสำหรับชิ้นงานอื่นๆ เช่น รูปภาพ คอลเล็กชัน และโฟลเดอร์อื่นๆ รูปภาพบางรูปอาจไม่ได้อยู่ในคอลเล็กชัน ชุดข้อมูลบางชุด เช่น โมเดลภูมิประเทศทั่วโลกบางชุด อาจประกอบด้วยรูปภาพเพียงรูปเดียว ไม่ว่าในกรณีใดๆ ระบบจะระบุชิ้นงานแต่ละรายการอย่างไม่ซ้ำกันด้วยเส้นทางที่ระบุตำแหน่งของชิ้นงานในแคตตาล็อกข้อมูลของ Earth Engine