หน้านี้จะแสดงวิธีควบคุมลักษณะการชนกันของเครื่องหมาย
ตั้งค่าลักษณะการชนให้กับเครื่องหมาย
ลักษณะการชนจะควบคุมลักษณะที่เครื่องหมายแสดงเมื่อเครื่องหมายชน (ซ้อนทับ) กับเครื่องหมายอื่น วิธีสร้างเครื่องหมายขั้นสูง จะกำหนดวิธีการทำงานของการชน ดังนี้
เครื่องหมายขั้นสูงที่สร้างโดยการใช้
BitmapDescriptorFactory
จะเรียกว่าเครื่องหมายบิตแมป ซึ่งวาดโดยแผนที่หลักเครื่องหมายขั้นสูงอื่นๆ ทั้งหมด รวมถึงเครื่องหมายที่สร้างขึ้นโดยใช้เมธอด
AdvancedMarkerOptions.iconView()
จะเรียกว่าเครื่องหมายมุมมอง และถูกวาดบนเลเยอร์เหนือแผนที่หลัก
หากต้องการตั้งค่าลักษณะการซ้อนทับ ให้ตั้งค่า AdvancedMarkerOptions.collisionBehavior
เป็นแบบใดแบบหนึ่งต่อไปนี้
CollisionBehavior.REQUIRED
: (ค่าเริ่มต้น) แสดงเครื่องหมายเสมอไม่ว่าจะมีการชนกันหรือไม่ก็ตามCollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL
แสดงเครื่องหมายเสมอโดยไม่คำนึงถึงการชน และซ่อนเครื่องหมายOPTIONAL_AND_HIDES_LOWER_PRIORITY
หรือป้ายกำกับที่จะทับซ้อนกับเครื่องหมายCollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY
แสดงเครื่องหมายเฉพาะ หากไม่ซ้อนทับกับเครื่องหมายอื่นๆหากเครื่องหมายบิตแมป 2 ตัวทับซ้อนกัน ระบบจะแสดงเครื่องหมายที่มี
zIndex
ที่สูงกว่า หากอุปกรณ์มีzIndex
เหมือนกัน หน้าจอที่มีตำแหน่งหน้าจอแนวตั้งอยู่ด้านล่างจะปรากฏขึ้น ดูข้อมูลเพิ่มเติมเกี่ยวกับzIndex
ได้ที่ดัชนีมาร์กเกอร์ zหากเครื่องหมายมุมมอง 2 รายการทับซ้อนกัน ระบบจะแสดงเครื่องหมายที่มี
zIndex
สูงกว่า หากมีzIndex
เหมือนกัน เครื่องหมายที่สร้างล่าสุดจะทับซ้อนกับเครื่องหมายที่สร้างไว้ก่อนหน้าเนื่องจากเครื่องหมาย view ถูกวาดบนเลเยอร์เหนือเครื่องหมาย bitmap ดังนั้นเครื่องหมาย view จึงซ้อนทับกับเครื่องหมาย bitmap คุณจึงควรใช้เครื่องหมายประเภทเดียวกันเพื่อการควบคุมการชนที่ดีขึ้น
ตัวอย่างต่อไปนี้แสดงลักษณะการชนกันของเครื่องหมาย
Kotlin
// Collision behavior can only be changed in the AdvancedMarkerOptions object. // Changes to collision behavior after a marker has been created are not possible val collisionBehavior: Int = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL val advancedMarkerOptions: AdvancedMarkerOptions = AdvancedMarkerOptions() .position(latLng) .collisionBehavior(collisionBehavior)
val marker: Marker = map.addMarker(advancedMarkerOptions)
Java
// Collision behavior can only be changed in the AdvancedMarkerOptions object. // Changes to collision behavior after a marker has been created are not possible int collisionBehavior = AdvancedMarkerOptions.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL; AdvancedMarkerOptions options = new AdvancedMarkerOptions() .position(latLng) .collisionBehavior(collisionBehavior);
Marker marker = map.addMarker(options);