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

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

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

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

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

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

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

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

مثال زیر نشان می‌دهد که چگونه یک شنونده کلیک تنظیم کنید و ابزارک پیش‌فرض Places UI را برای انجام یک اقدام سفارشی سرکوب کنید:

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
}