लोकप्रिय जगहों के साथ इंटरैक्ट करना

फ़ोटो में, स्क्रीन पर सबसे नीचे जगह की जानकारी वाला एक छोटा पॉपओवर दिख रहा है. यह पॉपओवर, क्लिक करने पर दिखता है.

जब कोई उपयोगकर्ता किसी लोकप्रिय जगह (पीओआई) पर क्लिक करता है, तो Android के लिए Maps 3D एसडीके, उस पीओआई के लिए जगहों की जानकारी देने वाला विजेट दिखाता है. OnMap3DClickListener का इस्तेमाल करके, क्लिक इवेंट को सुना जा सकता है और इस विजेट को दबाया जा सकता है. Places विजेट का इस्तेमाल करने के लिए, आपको Places SDK को डिपेंडेंसी के तौर पर जोड़ना होगा.

इवेंट पर क्लिक करने के लिए लिसन करें

मैप पर क्लिक इवेंट सुनने के लिए, अपने GoogleMap3D इंस्टेंस पर setMap3DClickListener को कॉल करें.

जब कोई उपयोगकर्ता मैप पर क्लिक करता है, तो onMap3DClick कॉलबैक को एक Map3DClickEvent ऑब्जेक्ट मिलता है. इसमें ये प्रॉपर्टी शामिल होती हैं:

  • location: LatLngAltitude, जो क्लिक के भौगोलिक निर्देशांक और ऊंचाई को दिखाता है.
  • placeId: क्लिक की गई जगह का यूनीक आइडेंटिफ़ायर (String?) या अगर कोई जगह नहीं है, तो null.

onMap3DClick वाला तरीका, Boolean लौटाता है:

  • false दिखाएं: यह Places यूज़र इंटरफ़ेस (यूआई) का डिफ़ॉल्ट विजेट दिखाता है. ऐसा तब होता है, जब placeId null न हो.
  • Return true: यह Places यूज़र इंटरफ़ेस (यूआई) के डिफ़ॉल्ट विजेट को दबा देता है.

यहां दिए गए उदाहरण में, क्लिक लिसनर को सेट करने और 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
}