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

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

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

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

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

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

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

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

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

בדוגמה הבאה אפשר לראות איך מגדירים רכיב click listener ומבטלים את ווידג'ט ממשק המשתמש של 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
}