کسب‌وکارها و دیگر نقاط جالب

پلاتفرم را انتخاب کنید: Android iOS JavaScript

به‌طور پیش‌فرض، نقاط موردعلاقه (POI) به‌همراه نمادهای مربوطه روی نقشه مبنا نشان داده می‌شوند. نقاط جالب شامل پارک‌ها، مدارس، ساختمان‌های دولتی، و غیره می‌شود.

علاوه‌براین، وقتی نوع نقشه 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();
            }
        });

      

نقاط موردعلاقه به‌طور پیش‌فرض روی نقشه ظاهر می‌شوند، اما واسط کاربر پیش‌فرضی برای کلیک کردن وجود ندارد. یعنی، وقتی کاربر روی نقطه موردعلاقه تک‌ضرب می‌زند، API به‌طور خودکار پنجره اطلاعات یا هر واسط کاربر دیگری را نمایش نمی‌دهد.

همان‌طور که نمونه بالا نشان می‌دهد، OnPoiClickListener را با فراخوانی GoogleMap.setOnPoiClickListener(OnPoiClickListener) روی نقشه تنظیم می‌کنید. وقتی کاربر روی نقطه موردعلاقه کلیک می‌کند (تک‌ضرب می‌زند)، برنامه شما رویداد OnPoiClick(PointOfInterest) دریافت می‌کند که نشان‌دهنده نقطه موردعلاقه‌ای است که کاربر روی آن کلیک کرده است. PointOfInterest حاوی مختصات طول/عرض جغرافیایی، شناسه مکان، و نام مکان جالب است.

متوقف کردن نمایش نقاط جالب در نقشه

می‌توانید با اعمال سبک‌های سفارشی برای همه نقاط موردعلاقه یا برای دسته‌های خاصی از نقاط موردعلاقه، آن‌ها را پنهان کنید.

اعلامیه سبک JSON زیر همه نقاط موردعلاقه کسب‌وکار را در نقشه پنهان می‌کند:

[
  {
    "featureType": "poi.business",
    "stylers": [
      { "visibility": "off" }
    ]
  }
]

به‌عنوان مثالی دیگر، JSON زیر نمایش همه دسته‌های نقاط جالب را ساده می‌کند:

[
  {
    "featureType": "poi",
    "stylers": [
      { "visibility": "simplified" }
    ]
  }
]

برای کد Java و جزئیات دیگر، راهنمای پنهان کردن ویژگی‌های نقشه با سبک‌بندی را ببینید.