التعامل مع أحداث النقر

يمكنك جعل طبقة ميزة تستجيب لأحداث click المستخدم للحصول على معرف الموقع الجغرافي ونوع العنصر للحدود التي تم النقر عليها. يعرض المثال التالي على الخريطة حدود طبقة "البلد"، ويعرض معالج أحداث يصِيغ المضلع الذي تم النقر عليه والمرتبط بالبلد الذي تم اختياره.

كتابة معالج حدث النقر

عند حدوث حدث نقرة على طبقة عناصر، تُرسِل حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android عنصرًا من نوع FeatureClickEvent إلى معالِج الأحداث. استخدِم FeatureClickEvent للحصول على إحداثيات خط العرض وخط الطول للنقرة وقائمة بالعناصر المتأثّرة بالنقرة.

التعامل مع أحداث طبقة العناصر

اتّبِع الخطوات التالية لمعالجة الأحداث في طبقة عناصر. في هذا المثال، يمكنك تحديد معالِج لحدث النقر لطبقة عناصر "البلد" لتطبيق حشوة باللون الأحمر على المضلع الذي يمثّل البلد المحدّد.

عند استدعاء FeatureLayer.setFeatureStyle()، تضبط دالة "منشأة الأنماط" النمط على جميع العناصر في طبقة العناصر. لتعديل نمط عنصر في معالِج الأحداث، عليك استدعاء FeatureLayer.setFeatureStyle() لضبط النمط المعدَّل على كل العناصر.

1. اتّبِع الخطوات الواردة في البدء لإنشاء رقم تعريف جديد للخريطة ونمط جديد للخريطة، إذا لم يسبق لك إجراء ذلك. احرص على تفعيل طبقة ميزة البلد.

2. تأكَّد من أنّ صفك ينفِّذ FeatureLayer.OnFeatureClickListener.

3. سجِّل معالِج حدث لأحداث النقر على العناصر من خلال استدعاء FeatureLayer.addOnFeatureClickListener().

   Java

   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);
   }
   

   Kotlin

   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. طبِّق لون تعبئة أحمر على البلد المحدّد. لا يمكن النقر إلا على الميزات المرئية.

   Java

   @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;
   }
   

   Kotlin

   // 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
   }