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

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

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

یک کنترل کننده رویداد کلیک بنویسید

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

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

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

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

1. اگر قبلاً این کار را انجام نداده اید، برای ایجاد شناسه نقشه و سبک نقشه جدید، مراحل را در Get Started دنبال کنید. حتماً لایه ویژگی کشور را فعال کنید.

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
   }