ניהול אירועי קליקים

בחירת פלטפורמה: Android iOS JavaScript

אפשר לגרום לתכונות של נתונים להגיב לאירועים של click, ולהשתמש בהן כדי לשנות את המראה של תכונה על סמך אינטראקציה של משתמשים.

כתיבת גורם מטפל באירועים מסוג קליק

כשמתרחש אירוע מסוג קליק בשכבה במפה, ה-SDK של מפות ל-Android מעביר אובייקט FeatureClickEvent לגורם המטפל באירועים.

משתמשים ב-method‏ FeatureClickEvent.getFeatures() כדי לקבל את רשימת התכונות שמושפעות מהקליק.

טיפול באירועים בשכבה במפה

כדי לטפל באירועים בשכבת מערכי הנתונים, צריך לפעול לפי השלבים הבאים. בדוגמה הזו, אתם מחילים מילוי וגבול כחולים על הפוליגון שמייצג את הישות שנבחרה.

הערה: בדוגמה הזו, המאפיין globalid של קבוצת הנתונים מכיל מזהה ייחודי לכל פוליגון. לאחר מכן, אפשר לבדוק את ה-globalid של הפוליגון שעליו לחצו כדי להחיל את הסגנון הכחול רק על הפוליגון הזה.

כשקוראים לפונקציה FeatureLayer.setFeatureStyle(), פונקציית ה-factory של הסגנון מגדירה את סגנון התכונה בכל התכונות בקבוצת הנתונים. כדי לעדכן את הסגנון של מערך נתונים בגורם המטפל באירועים, צריך להפעיל את FeatureLayer.setFeatureStyle() כדי להגדיר את הסגנון המעודכן בכל הישויות של מערך הנתונים.

1. אם עדיין לא עשיתם זאת, בצעו את השלבים שמפורטים בקטע תחילת העבודה כדי ליצור מזהה מפה וסגנון מפה חדשים. חשוב להפעיל את שכבת התכונות Datasets.

2. מוודאים שהמחלקה מטמיעה את FeatureLayer.OnFeatureClickListener.

3. רושמים גורם מטפל באירועים מסוג קליק על ישות באמצעות קריאה ל-FeatureLayer.addOnFeatureClickListener().

   Kotlin

   private var datasetLayer: FeatureLayer? = null
   // The globalid of the clicked dataset feature.
   var lastGlobalId: String? = null
   
   override fun onMapReady(googleMap: GoogleMap) {
     // Get the DATASET feature layer.
     datasetLayer = googleMap.getFeatureLayer(FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build())
   
     // Register the click event handler for the Datasets layer.
     datasetLayer?.addOnFeatureClickListener(this)
   
     // Apply default style to all features on load to enable clicking.
     styleDatasetsLayer()
   }
   
   // Define the click event handler to set lastGlobalId to globalid of selected feature.
   override fun onFeatureClick(event: FeatureClickEvent) {
     // Get the dataset feature affected by the click.
     val clickFeatures: MutableList<Feature> = event.features
     lastGlobalId = null
     if (clickFeatures.get(0) is DatasetFeature) {
         lastGlobalId = ((clickFeatures.get(0) as DatasetFeature).getDatasetAttributes().get("globalid"))
         // Remember to reset the Style Factory.
         styleDatasetsLayer()
     }
   }

   Java

   private FeatureLayer datasetLayer;
   // The globalid of the clicked dataset feature.
   String lastgobalid = null;
   
   @Override
   public void onMapReady(GoogleMap map) {
   
     // Get the DATASET feature layer.
     datasetLayer = map.getFeatureLayer(new FeatureLayerOptions.Builder()
       .featureType(FeatureType.DATASET)
       // Specify the dataset ID.
       .datasetId(YOUR_DATASET_ID)
       .build());
   
     // Register the click event handler for the Datasets layer.
     datasetLayer.addOnFeatureClickListener(this);
   
     // Apply default style to all features on load to enable clicking.
     styleDatasetsLayer();
   }
   
   @Override
   // Define the click event handler.
   public void onFeatureClick(FeatureClickEvent event) {
     // Get the dataset feature affected by the click.
     List<Feature> clickFeatures = event.getFeatures();
     lastgobalid = null;
     if (clickFeatures.get(0) instanceof DatasetFeature) {
         lastgobalid = ((DatasetFeature) clickFeatures.get(0)).getDatasetAttributes().get("globalid");
         // Remember to reset the Style Factory.
         styleDatasetsLayer();
     }
   }

4. מגדירים צבע מילוי כחול לתכונה שנבחרה וצבע מילוי ירוק לכל שאר התכונות. אפשר ללחוץ רק על ישויות גלויות.

   Kotlin

   // Set fill and border for all features.
   private fun styleDatasetsLayer() {
       // Create the style factory function.
       val styleFactory = FeatureLayer.StyleFactory { feature: Feature ->
   
       // Check if the feature is an instance of DatasetFeature.
       if (feature is DatasetFeature) {
         val globalIDs: MutableMap<String, String> = feature.getDatasetAttributes()
         // Determine globalid attribute.
         val globalID = globalIDs!!["globalid"]
         // Set default colors to to green.
         var fillColor = 0x800000ff
         var strokeColor = 0xff0000ff
         if (globalID == lastGlobalId) {
           // Color selected area blue.
           fillColor = 0x8000ff00
           strokeColor = 0xff00ff00
         }
         return@StyleFactory FeatureStyle.Builder()
             .fillColor(fillColor)
             .strokeColor(strokeColor)
             .build()
       }
       return@StyleFactory null
     }
   
     // Apply the style factory function to the dataset feature layer.
     datasetLayer?.setFeatureStyle(styleFactory)
   }

   Java

   // Set default green fill and border for all features.
   private void styleDatasetsLayer() {
     // Create the style factory function.
     FeatureLayer.StyleFactory styleFactory = (Feature feature) -> {
   
     // Check if the feature is an instance of DatasetFeature.
     if (feature instanceof DatasetFeature) {
   
       // Check if "globalid" attribute of feature is the "globalid" of clicked feature.
       Map<String, String> globalIDs = ((DatasetFeature) feature).getDatasetAttributes();
       String globalID = globalIDs.get("globalid");
       // Set default colors to green.
       int fillColor = 0x4000ff00;
       int strokeColor = 0xff00ff00;
       if (Objects.equals(globalID, lastgobalid)) {
         // Color selected area blue.
         fillColor = 0x400000ff;
         strokeColor = 0xff0000ff;
       }
       return new FeatureStyle.Builder()
         .fillColor(fillColor)
         .strokeColor(strokeColor)
         .strokeWidth(2)
         .build();
       }
       return null;
     };
   
     // Apply the style factory function to the feature layer.
     datasetLayer.setFeatureStyle(styleFactory);
   }