ระบบจะเพิ่มแถบหรือข้อมูลเมตาที่ระบุลงในรูปภาพต้นฉบับจากรูปภาพที่พบในคอลเล็กชัน และหากมีแถบหรือข้อมูลเมตาอยู่แล้ว ระบบจะเขียนทับ หากไม่พบรูปภาพที่ตรงกัน ระบบจะมาสก์แถบข้อมูลใหม่หรือที่อัปเดตแล้วทั้งหมด และข้อมูลเมตาใหม่หรือที่อัปเดตแล้วจะเป็นค่าว่าง ร่องรอยเอาต์พุตจะเหมือนกับร่องรอยของรูปภาพต้นทาง
ระบบจะพิจารณาว่ารูปภาพตรงกันหากรูปภาพต้นฉบับและรูปภาพในคอลเล็กชันมีพร็อพเพอร์ตี้ข้อมูลเมตาที่เทียบเท่ากัน หากมีรูปภาพคอลเล็กชันมากกว่า 1 รูปที่ตรงกัน ระบบจะเลือกรูปภาพคอลเล็กชันแบบสุ่ม โดยค่าเริ่มต้น ระบบจะจับคู่รูปภาพในพร็อพเพอร์ตี้ข้อมูลเมตา "system:index"
ฟังก์ชันการลิงก์นี้เป็นวิธีที่สะดวกในการเพิ่มแถบสีลงในรูปภาพเป้าหมายโดยอิงตามพร็อพเพอร์ตี้ข้อมูลเมตาที่แชร์ที่ระบุ และมีจุดประสงค์เพื่อรองรับการลิงก์คอลเล็กชันที่ใช้การประมวลผล/การสร้างผลิตภัณฑ์ที่แตกต่างกันกับภาพต้นฉบับเดียวกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับการลิงก์ที่สื่อความหมายมากขึ้นที่เรียกว่า "การรวม" ได้ที่ https://developers.google.com/earth-engine/guides/joins_intro
| การใช้งาน | การคืนสินค้า |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | รูปภาพ |
| อาร์กิวเมนต์ | ประเภท | รายละเอียด |
|---|---|---|
ดังนี้ input | รูปภาพ | ระบบจะลิงก์รูปภาพต้นฉบับกับรูปภาพที่ตรงกันในคอลเล็กชัน |
imageCollection | ImageCollection | คอลเล็กชันรูปภาพที่ค้นหาเพื่อดึงรูปภาพที่ตรงกับแหล่งที่มา |
linkedBands | ออบเจ็กต์ ค่าเริ่มต้น: null | ชื่อวงดนตรีหรือรายชื่อวงดนตรีที่จะเพิ่มหรืออัปเดตจากรูปภาพที่ตรงกัน |
linkedProperties | ออบเจ็กต์ ค่าเริ่มต้น: null | พร็อพเพอร์ตี้ข้อมูลเมตาหรือรายการพร็อพเพอร์ตี้ที่จะเพิ่มหรืออัปเดตจากรูปภาพที่ตรงกัน |
matchPropertyName | สตริง ค่าเริ่มต้น: "system:index" | ชื่อพร็อพเพอร์ตี้ข้อมูลเมตาที่จะใช้เป็นเกณฑ์การจับคู่ |