تظهر نقاط الاهتمام تلقائيًا على الخريطة الأساسية مع الرموز المقابلة لها. تشمل نقاط الاهتمام المنتزهات والمدارس والمباني الحكومية وغير ذلك.
بالإضافة إلى ذلك، تظهر نقاط الاهتمام التجارية تلقائيًا على الخريطة عندما يكون نوع الخريطة
normal. تمثّل نقاط الاهتمام التجارية المؤسسات التجارية، مثل المتاجر والمطاعم والفنادق وغير ذلك. لا تظهر نقاط الاهتمام التجارية على الخرائط الداخلية (مخططات المباني) إلا على خريطة
الوضع البسيط.
تتوافق نقطة الاهتمام مع رقم تعريف المكان، كما هو محدّد في حزمة تطوير برامج الأماكن لأجهزة Android. على سبيل المثال، المنتزهات الترفيهية هي نقاط اهتمام، ولكنّ أشياء مثل نوافير المياه ليست نقاط اهتمام بشكل عام (إلا إذا كانت ذات أهمية وطنية أو تاريخية).
الاستماع إلى أحداث النقر على نقاط الاهتمام
إذا أردت الاستجابة لنقر المستخدم على نقطة اهتمام، يمكنك استخدام
OnPoiClickListener كما هو موضّح في نموذج الرمز البرمجي التالي:
Kotlin
map.setOnPoiClickListener { poi -> Toast.makeText( context, """Clicked: ${poi.name} Place ID:${poi.placeId} Latitude:${poi.latLng.latitude} Longitude:${poi.latLng.longitude}""", Toast.LENGTH_SHORT ).show() }
جافا
map.setOnPoiClickListener(new GoogleMap.OnPoiClickListener() { @Override public void onPoiClick(PointOfInterest poi) { Toast.makeText(context, "Clicked: " + poi.name + "\nPlace ID:" + poi.placeId + "\nLatitude:" + poi.latLng.latitude + " Longitude:" + poi.latLng.longitude, Toast.LENGTH_SHORT).show(); } });
تظهر نقاط الاهتمام على الخريطة تلقائيًا، ولكن لا توجد واجهة مستخدم تلقائية عند النقر. أي أنّ واجهة برمجة التطبيقات لا تعرض تلقائيًا نافذة معلومات أو أي واجهة مستخدم أخرى عندما ينقر المستخدم على نقطة اهتمام.
كما يوضّح النموذج أعلاه، يمكنك ضبط
OnPoiClickListener على الخريطة من خلال
استدعاء
GoogleMap.setOnPoiClickListener(OnPoiClickListener).
عندما ينقر المستخدم على نقطة اهتمام، يتلقّى تطبيقك حدث
OnPoiClick(PointOfInterest) يشير إلى نقطة الاهتمام التي نقر عليها المستخدم. The
PointOfInterest تحتوي على إحداثيات خطوط الطول والعرض،
رقم تعريف المكان واسم نقطة الاهتمام.
إيقاف عرض نقاط الاهتمام على الخريطة
يمكنك إخفاء نقاط الاهتمام من خلال تطبيق أنماط مخصّصة على جميع نقاط الاهتمام أو على فئات معيّنة من نقاط الاهتمام.
يخفي إعلان النمط بتنسيق JSON التالي جميع نقاط الاهتمام التجارية على الخريطة:
[
{
"featureType": "poi.business",
"stylers": [
{ "visibility": "off" }
]
}
]
كمثال آخر، يسهّل تنسيق JSON التالي عرض جميع فئات نقاط الاهتمام:
[
{
"featureType": "poi",
"stylers": [
{ "visibility": "simplified" }
]
}
]
للحصول على رمز Java وتفاصيل أخرى، اطّلِع على دليل إخفاء ميزات الخريطة باستخدام الأنماط.