التفاعل مع نقاط الاهتمام

عندما ينقر المستخدم على نقطة اهتمام، تعرض حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android أداة "أدوات تحديد الأماكن" لنقطة الاهتمام هذه. يمكنك الاستماع إلى أحداث النقر وإيقاف هذه الأداة باستخدام OnMap3DClickListener. تتطلّب أداة "تحديد الأماكن" إضافة حزمة تطوير البرامج (SDK) الخاصة بـ الأماكن SDK كإحدى التبعيات.

ملاحظة: بشكلٍ تلقائي، تظهر أداة واجهة مستخدم "الأماكن" عند النقر على نقطة اهتمام. يجب إلغاء هذا السلوك لإيقاف الأداة في تطبيقك.

الاستماع إلى أحداث النقر

للاستماع إلى أحداث النقر على الخريطة، استخدِم طريقة setMap3DClickListener على مثيل GoogleMap3D.

عندما ينقر المستخدم على الخريطة، يتلقّى ردّ الاتصال onMap3DClick كائن Map3DClickEvent يحتوي على الخصائص التالية:

• location: الكائن LatLngAltitude الذي يمثّل الإحداثيات الجغرافية والارتفاع للنقرة.
• placeId: المعرّف الفريد (String?) للمكان في موقع النقر، أو null إذا لم يكن هناك مكان.

تعرض طريقة onMap3DClick قيمة Boolean:

• عرض false: يعرض أداة واجهة مستخدم "الأماكن" التلقائية (إذا placeId لم تكن null).
• زرّ Return 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
}