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

اختيار النظام الأساسي: Android iOS JavaScript

جعل ميزات البيانات تستجيب لأحداث click وتستخدمها من أجل تغيير مظهر الميزة بناءً على تفاعل المستخدم.

لقطة شاشة تعرض بيانات المضلّع ذات الأنماط.

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

عند حدوث نقرة على إحدى طبقات الميزات، تجتاز حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android FeatureClickEvent إلى معالج الحدث.

استخدام طريقة FeatureClickEvent.getFeatures() للحصول على قائمة الميزات المتأثرة بالنقرة.

التعامل مع أحداث طبقة الميزات

اتخذ الخطوات التالية للتعامل مع الأحداث على طبقة مجموعات البيانات. في هذه الدورة، مثلاً، يمكنك تطبيق تعبئة زرقاء وحدود على المضلّع الذي يمثل الميزة المحددة.

عند الاتصال FeatureLayer.setFeatureStyle(), تحدد دالة المصنع النمط نمط الميزة على جميع الخصائص في مجموعة البيانات الأصلية. لتعديل نمط مجموعة بيانات في معالِج الأحداث، يجب طلب FeatureLayer.setFeatureStyle() لضبط النمط المحدّث على كل مجموعة البيانات الجديدة.

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

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