تعامل با نقاط موردعلاقه

وقتی کاربر روی نقطه موردعلاقه (POI) کلیک می‌کند، «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android» ابزاره مکان‌ها را برای آن نقطه موردعلاقه نمایش می‌دهد. می‌توانید به رویدادهای کلیک گوش دهید و این ابزارک را بااستفاده از OnMap3DClickListener سرکوب کنید. ابزاره «مکان‌ها» از شما می‌خواهد کیت توسعه نرم‌افزار مکان‌ها را به‌عنوان وابستگی اضافه کنید.

توجه: به‌طور پیش‌فرض، ابزارک «میانای کاربری مکان‌ها» زمانی نشان داده می‌شود که روی نقطه موردعلاقه‌ای کلیک شود. برای سرکوب کردن ابزاره در برنامه‌تان، باید این رفتار را ملغی کنید.

گوش دادن به رویدادهای کلیک

برای گوش دادن به رویدادهای کلیک روی نقشه، setMap3DClickListener را در نمونه GoogleMap3D فراخوانی کنید.

وقتی کاربر روی نقشه کلیک می‌کند، onMap3DClick فراخوانی برگشتی یک شیء Map3DClickEvent دریافت می‌کند که حاوی ویژگی‌های زیر است:

• location: The LatLngAltitude نشان‌دهنده مختصات جغرافیایی و ارتفاع کلیک.
• placeId: شناسه یکتا (String?) برای مکان در محل کلیک، یا null اگر وجود نداشته باشد.

روش onMap3DClick Boolean را برمی‌گرداند:

• Return false: ابزاره UI پیش‌فرض «مکان‌ها» را نشان می‌دهد (اگر placeId null نباشد).
• برگشت true: ابزاره واسط کاربر پیش‌فرض «مکان‌ها» را غیرفعال می‌کند.

مثال زیر نشان می‌دهد که چگونه شنونده کلیک تنظیم کنید و ابزارک رابط کاربری پیش‌فرض «مکان‌ها» را برای انجام کنش سفارشی غیرفعال کنید:

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
}