เมื่อผู้ใช้คลิกจุดที่น่าสนใจ (POI) Maps 3D SDK สำหรับ Android จะแสดงวิดเจ็ตสถานที่สำหรับจุดที่น่าสนใจนั้น คุณสามารถฟังกิจกรรมการคลิกและระงับวิดเจ็ตนี้ได้โดยใช้ OnMap3DClickListener
วิดเจ็ต Places กำหนดให้คุณต้องเพิ่ม Places SDK เป็นทรัพยากร Dependency
ฟังกิจกรรมการคลิก
หากต้องการฟังกิจกรรมการคลิกบนแผนที่ ให้เรียกใช้ setMap3DClickListener ในอินสแตนซ์ GoogleMap3D
เมื่อผู้ใช้คลิกบนแผนที่ คอลแบ็ก onMap3DClick จะได้รับออบเจ็กต์ Map3DClickEvent ที่มีพร็อพเพอร์ตี้ต่อไปนี้
location:LatLngAltitudeที่แสดงพิกัดทางภูมิศาสตร์และระดับความสูงของการคลิกplaceId: ตัวระบุที่ไม่ซ้ำกัน (String?) สำหรับสถานที่ ณ ตำแหน่งที่คลิก หรือnullหากไม่มี
เมธอด onMap3DClick จะแสดงผล Boolean ดังนี้
- Return
false: แสดงวิดเจ็ต UI ของ Places เริ่มต้น (หากplaceIdไม่ใช่null) - Return
true: ซ่อนวิดเจ็ต UI ของ Places เริ่มต้น
ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าฟังก์ชันรอคลิกและระงับวิดเจ็ต 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
}