رویدادهای کلیک را مدیریت کنید

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

نوشتن یک کنترل کننده رویداد کلیک

وقتی یک رویداد کلیک روی یک لایه ویژگی رخ می‌دهد، Maps SDK برای اندروید یک شیء FeatureClickEvent را به کنترل‌کننده رویداد ارسال می‌کند. از FeatureClickEvent برای دریافت مختصات طول و عرض جغرافیایی کلیک و لیستی از ویژگی‌های تحت تأثیر کلیک استفاده کنید.

مدیریت رویدادهای لایه ویژگی

برای مدیریت رویدادها روی یک لایه ویژگی، مراحل زیر را انجام دهید. در این مثال، یک کنترل‌کننده رویداد کلیک برای لایه ویژگی کشور تعریف می‌کنید تا یک رنگ قرمز را روی چندضلعی نشان دهنده کشور انتخاب شده اعمال کند.

وقتی شما FeatureLayer.setFeatureStyle() را فراخوانی می‌کنید، تابع style factory استایل را روی تمام ویژگی‌های موجود در لایه ویژگی تنظیم می‌کند. برای به‌روزرسانی استایل یک ویژگی در event handler، باید FeatureLayer.setFeatureStyle() را فراخوانی کنید تا استایل به‌روزرسانی‌شده روی تمام ویژگی‌ها تنظیم شود.

1. اگر قبلاً این کار را نکرده‌اید، مراحل موجود در بخش «شروع به کار» را برای ایجاد شناسه نقشه و سبک نقشه جدید دنبال کنید. حتماً لایه ویژگی کشور (Country feature layer) را فعال کنید.

2. مطمئن شوید که کلاس شما FeatureLayer.OnFeatureClickListener را پیاده‌سازی می‌کند.

3. با فراخوانی FeatureLayer.addOnFeatureClickListener() یک کنترل‌کننده رویداد برای رویدادهای کلیک ویژگی ثبت کنید.

   جاوا

   private FeatureLayer countryLayer;
   
   @Override
   public void onMapReady(GoogleMap map) {
   
     // Get the COUNTRY feature layer.
     countryLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.COUNTRY)
       .build());
   
     // Register the click event handler for the Country layer.
     countryLayer.addOnFeatureClickListener(this);
   
     // Apply default style to all countries on load to enable clicking.
     styleCountryLayer();
   }
   
   // Set default fill and border for all countries to ensure that they respond
   // to click events.
   private void styleCountryLayer() {
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
       return new FeatureStyle.Builder()
         // Set the fill color for the country as white with a 10% opacity.
         .fillColor(Color.argb(0.1, 0, 0, 0))
         // Set border color to solid black.
         .strokeColor(Color.BLACK)
         .build();
     };
   
     // Apply the style factory function to the country feature layer.
     countryLayer.setFeatureStyle(styleFactory);
   }

   کاتلین

   private var countryLayer: FeatureLayer? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the COUNTRY feature layer.
     countryLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.COUNTRY)
       .build())
   
     // Register the click event handler for the Country layer.
     countryLayer?.addOnFeatureClickListener(this)
   
     // Apply default style to all countries on load to enable clicking.
     styleCountryLayer()
   }
   
   // Set default fill and border for all countries to ensure that they respond
   // to click events.
   private fun styleCountryLayer() {
     val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
       return@StyleFactory FeatureStyle.Builder()
         // Set the fill color for the country as white with a 10% opacity.
         .fillColor(Color.argb(0.1f, 0f, 0f, 0f))
         // Set border color to solid black.
         .strokeColor(Color.BLACK)
         .build()
     }
   
     // Apply the style factory function to the country feature layer.
     countryLayer?.setFeatureStyle(styleFactory)
   }

4. رنگ قرمز را به کشور انتخاب شده اعمال کنید. فقط ویژگی‌های قابل مشاهده قابل کلیک هستند.

   جاوا

   @Override
   // Define the click event handler.
   public void onFeatureClick(FeatureClickEvent event) {
   
     // Get the list of features affected by the click using
     // getPlaceIds() defined below.
     List<String> selectedPlaceIds = getPlaceIds(event.getFeatures());
   
     if (!selectedPlaceIds.isEmpty()) {
       FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
         // Use PlaceFeature to get the placeID of the country.
         if (feature instanceof PlaceFeature) {
           if (selectedPlaceIds.contains(((PlaceFeature) feature).getPlaceId())) {
             return new FeatureStyle.Builder()
                 // Set the fill color to red.
                 .fillColor(Color.RED)
                 .build();
           }
         }
         return null;
       };
   
       // Apply the style factory function to the feature layer.
       countryLayer.setFeatureStyle(styleFactory);
     }
   }
   
   // Get a List of place IDs from the FeatureClickEvent object.
   private List<String> getPlaceIds(List<Feature> features) {
     List<String> placeIds = new ArrayList<>();
     for (Feature feature : features) {
       if (feature instanceof PlaceFeature) {
           placeIds.add(((PlaceFeature) feature).getPlaceId());
       }
     }
     return placeIds;
   }

   کاتلین

   // Define the click event handler.
   override fun onFeatureClick(event: FeatureClickEvent) {
   
     // Get the list of features affected by the click using
     // getPlaceIds() defined below.
     val selectedPlaceIds = getPlaceIds(event.getFeatures())
     if (!selectedPlaceIds.isEmpty()) {
         val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
             // Use PlaceFeature to get the placeID of the country.
             if (feature is PlaceFeature) {
                 if (selectedPlaceIds.contains((feature as PlaceFeature).getPlaceId())) {
                     return@StyleFactory FeatureStyle.Builder()
                         // Set the fill color to red.
                         .fillColor(Color.RED)
                         .build()
                 }
             }
             return@StyleFactory null
         }
   
         // Apply the style factory function to the feature layer.
         countryLayer?.setFeatureStyle(styleFactory)
     }
   }
   
   // Get a List of place IDs from the FeatureClickEvent object.
   private fun getPlaceIds(features: List<Feature>): List<String> {
     val placeIds: MutableList<String> = ArrayList()
     for (feature in features) {
         if (feature is PlaceFeature) {
             placeIds.add((feature as PlaceFeature).getPlaceId())
         }
     }
     return placeIds
   }