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

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

ध्यान दें: डिफ़ॉल्ट रूप से, Places UI विजेट तब दिखता है, जब किसी लोकप्रिय जगह पर क्लिक किया जाता है. अपने ऐप्लिकेशन में विजेट को छिपाने के लिए, आपको इस व्यवहार को बदलना होगा.

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

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

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

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

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

• Return false: यह डिफ़ॉल्ट Places UI विजेट दिखाता है. ऐसा तब होता है, जब placeId, null नहीं होता है.
• Return true: डिफ़ॉल्ट Places UI विजेट को दबाता है.

यहां दिए गए उदाहरण में, कस्टम ऐक्शन करने के लिए, क्लिक लिसनर सेट करने और Places API के डिफ़ॉल्ट यूज़र इंटरफ़ेस (यूआई) विजेट को बंद करने का तरीका बताया गया है:

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
}