تظهر نقاط الاهتمام تلقائيًا على الخريطة الأساسية مع الرموز المقابلة لها. تشمل نقاط الاهتمام المتنزهات والمدارس والمباني الحكومية والمزيد.
بالإضافة إلى ذلك، تظهر نقاط الاهتمام التجارية تلقائيًا على الخريطة عندما يكون نوع الخريطة
normal. تمثّل نقاط الاهتمام التجارية أنشطة تجارية مثل المتاجر والمطاعم والفنادق وغيرها. لا تظهر نقاط الاهتمام التجارية على الخرائط الداخلية (مخططات المباني) إلا على خريطة في الوضع البسيط.
تتوافق نقطة الاهتمام مع رقم تعريف المكان، كما هو محدّد في حزمة تطوير البرامج (SDK) للأماكن على 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)
يشير إلى نقطة الاهتمام التي نقر عليها المستخدم. يحتوي
PointOfInterest على إحداثيات خطوط العرض/الطول
ورقم تعريف المكان واسم المكان المثير للاهتمام.
إيقاف عرض نقاط الاهتمام على الخريطة
يمكنك إخفاء المعالم من خلال تطبيق أنماط مخصّصة على جميع المعالم أو على فئات معيّنة منها.
يؤدي بيان نمط JSON التالي إلى إخفاء جميع نقاط الاهتمام التجارية على الخريطة:
[
{
"featureType": "poi.business",
"stylers": [
{ "visibility": "off" }
]
}
]
كمثال آخر، يعمل ملف JSON التالي على تبسيط عرض جميع فئات نقاط الاهتمام:
[
{
"featureType": "poi",
"stylers": [
{ "visibility": "simplified" }
]
}
]
للاطّلاع على رمز Java وتفاصيل أخرى، يُرجى مراجعة دليل إخفاء ميزات الخريطة باستخدام الأنماط.