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

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

کاری کنید که ویژگی‌های داده به رویدادهای click پاسخ دهند و از آنها برای تغییر ظاهر یک ویژگی بر اساس تعامل کاربر استفاده کنید.

تصویری که داده های چند ضلعی استایل شده را نشان می دهد.

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

هنگامی که یک رویداد کلیک روی یک لایه ویژگی رخ می دهد، Maps SDK برای Android یک شی FeatureClickEvent به کنترل کننده رویداد ارسال می کند.

از متد FeatureClickEvent.getFeatures() برای دریافت لیستی از ویژگی های تحت تاثیر کلیک استفاده کنید.

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

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

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

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

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

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

    کاتلین

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

    جاوا

    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. رنگ پر آبی را به ویژگی انتخاب شده و سبز را برای سایر ویژگی ها اعمال کنید. فقط ویژگی های قابل مشاهده قابل کلیک هستند.

    کاتلین

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

    جاوا

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