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

صورة تعرض نافذة منبثقة صغيرة تتضمّن تفاصيل المكان في أسفل الشاشة تظهر عند النقر على المكان

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

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

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

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

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

يعرض الإجراء onMap3DClick Boolean:

  • Return false: لعرض التطبيق المصغّر التلقائي لواجهة مستخدم "الأماكن" (إذا لم تكن قيمة placeId هي null).
  • Return true: لإيقاف التطبيق المصغّر التلقائي لواجهة مستخدم Places.

يوضّح المثال التالي كيفية ضبط متتبِّع النقرات وإيقاف أداة واجهة مستخدم 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
}