โต้ตอบกับจุดที่น่าสนใจ

รูปภาพแสดงป๊อปโอเวอร์ขนาดเล็กที่มีรายละเอียดสถานที่ที่ด้านล่างของหน้าจอซึ่งเป็นผลมาจากการคลิก

เมื่อผู้ใช้คลิกจุดที่น่าสนใจ (POI) Maps 3D SDK สำหรับ Android จะแสดงวิดเจ็ตสถานที่ Places สำหรับ POI นั้น คุณสามารถฟังกิจกรรมการคลิกและระงับวิดเจ็ตนี้ได้โดยใช้ OnMap3DClickListener วิดเจ็ต Places กำหนดให้คุณต้องเพิ่ม Places SDK เป็นการพึ่งพา

ฟังกิจกรรมการคลิก

หากต้องการฟังกิจกรรมการคลิกบนแผนที่ ให้เรียกใช้ setMap3DClickListener ในอินสแตนซ์ GoogleMap3D

เมื่อผู้ใช้คลิกบนแผนที่ ฟังก์ชันเรียกกลับ onMap3DClick จะได้รับออบเจ็กต์ Map3DClickEvent ที่มีพร็อพเพอร์ตี้ต่อไปนี้

  • location: The LatLngAltitude ที่แสดงพิกัดทางภูมิศาสตร์และความสูงของการคลิก
  • placeId: ตัวระบุที่ไม่ซ้ำกัน (String?) สำหรับสถานที่ที่ตำแหน่งการคลิก หรือ null หากไม่มี

เมธอด onMap3DClick จะแสดงผล Boolean ดังนี้

  • Return false: แสดงวิดเจ็ต UI ของ Places เริ่มต้น (หาก placeId ไม่ใช่ null)
  • Return true: ระงับวิดเจ็ต UI ของ Places เริ่มต้น

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่า Listener การคลิกและระงับวิดเจ็ต UI ของ Places เริ่มต้นเพื่อดำเนินการที่กำหนดเอง

googleMap3D.setMap3DClickListener { clickEvent ->
    val location = clickEvent.location
    val placeId = clickEvent.placeId

    // Perform custom action, for example logging or showing a custom tooltip
    showCustomTooltip(location, placeId)

    // Suppress the default Places UI widget by returning true
    true
}