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

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

เมื่อผู้ใช้คลิกจุดที่น่าสนใจ (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
}