אינטראקציה עם נקודות עניין

כשמשתמש לוחץ על נקודת עניין (POI), ערכת Maps 3D SDK ל-Android מציגה ווידג'ט של מקומות לאותה נקודת עניין. אפשר להאזין לאירועי מסוג קליק ולהסתיר את הווידג'ט הזה באמצעות OnMap3DClickListener. כדי להשתמש בווידג'ט Places, צריך להוסיף את Places SDK כתלות.

הערה: כברירת מחדל, הווידג'ט של ממשק המשתמש של Places מוצג כשלוחצים על נקודת עניין. כדי להסתיר את הווידג'ט באפליקציה, צריך לשנות את ההתנהגות הזו.

האזנה לאירועים מסוג קליק

כדי להאזין לאירועים מסוג קליק במפה, צריך להפעיל את setMap3DClickListener במופע של GoogleMap3D.

כשמשתמש לוחץ על המפה, פונקציית הקריאה החוזרת (callback) onMap3DClick מקבלת אובייקט Map3DClickEvent שמכיל את המאפיינים הבאים:

• ‫location: הערך LatLngAltitude מייצג את הקואורדינטות הגיאוגרפיות ואת הגובה של הקליק.
• ‫placeId: המזהה הייחודי (String?) של המקום במיקום הקליק, או null אם אין מקום כזה.

השיטה onMap3DClick מחזירה Boolean:

• החזרה false: הצגת הווידג'ט של ממשק המשתמש של Places (אם placeId לא null).
• ‫Return true: מבטל את ווידג'ט ממשק המשתמש של Places שמוגדר כברירת מחדל.

בדוגמה הבאה מוצג איך להגדיר רכיב click listener ולהשבית את הווידג'ט של ממשק המשתמש של מקומות שמוגדר כברירת מחדל, כדי לבצע פעולה מותאמת אישית:

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
}