Klickereignisse verarbeiten

Plattform auswählen: Android iOS JavaScript

Sie können eine Feature-Ebene so konfigurieren, dass auf click-Ereignisse des Nutzers reagiert wird, um die Orts-ID und den Featuretyp der angeklickten Grenze zu erhalten. Auf der folgenden Beispielkarte sehen Sie Grenzen für die Länderebene. Sie enthält einen Event-Handler, mit dem das angeklickte Polygon, das mit dem ausgewählten Land verknüpft ist, lila ausgefüllt wird.

Click-Event-Handler schreiben

Wenn ein Click-Event in einer Element-Ebene auftritt, übergibt das Maps SDK for Android ein FeatureClickEvent-Objekt an den Event-Handler. Mit FeatureClickEvent können Sie die Breiten- und Längengradkoordinaten des Klicks sowie eine Liste der vom Klick betroffenen Features abrufen.

Ereignisse auf Element-Ebene verarbeiten

So behandeln Sie Ereignisse auf Feature-Ebene: In diesem Beispiel definieren Sie einen Click-Event-Handler für den Feature-Layer „Country“, um das Polygon, das das ausgewählte Land darstellt, rot zu füllen.

Wenn Sie FeatureLayer.setFeatureStyle()> aufrufen, wird mit der Stil-Factory-Funktion der Stil für alle Elemente auf der Elementebene festgelegt. Wenn Sie den Stil eines Elements im Event-Handler aktualisieren möchten, müssen Sie FeatureLayer.setFeatureStyle() aufrufen, um den aktualisierten Stil für alle Elemente festzulegen.

  1. Falls noch nicht geschehen, erstellen Sie eine neue Karten-ID und einen neuen Kartenstil. Folgen Sie dazu der Anleitung unter Erste Schritte. Aktivieren Sie auf jeden Fall die Element-Ebene Land.

  2. Achten Sie darauf, dass Ihre Klasse FeatureLayer.OnFeatureClickListener implementiert.

  3. Um einen Event-Handler für Feature-Klickereignisse zu registrieren, rufen Sie FeatureLayer.addOnFeatureClickListener() auf.

    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. Wenden Sie auf das ausgewählte Land die Füllfarbe Rot an. Nur sichtbare Features sind anklickbar.

    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
}