Mit POIs interagieren

Foto, das ein kleines Pop-over mit Ortsdetails unten auf dem Bildschirm zeigt, das durch einen Klick aufgerufen wurde.

Wenn ein Nutzer auf einen POI klickt, zeigt das Maps 3D SDK for Android ein Places-Widget für diesen POI an. Sie können mit OnMap3DClickListener auf Click-Events warten und dieses Widget unterdrücken. Für das Places-Widget müssen Sie das Places SDK als Abhängigkeit hinzufügen.

Auf Click-Events warten

Wenn Sie auf Click-Events auf der Karte warten möchten, rufen Sie setMap3DClickListener für Ihre GoogleMap3D Instanz auf.

Wenn ein Nutzer auf die Karte klickt, empfängt der onMap3DClick -Callback ein Map3DClickEvent -Objekt mit den folgenden Eigenschaften:

  • location: Der LatLngAltitude der die geografischen Koordinaten und die Höhe des Klicks darstellt.
  • placeId: Die eindeutige Kennung (String?) für den Ort an der Klickposition oder null, falls keine vorhanden ist.

Die onMap3DClick Methode gibt einen Boolean-Wert zurück:

  • Zurückgeben false: Das Standard-Places UI-Widget wird angezeigt (wenn placeId nicht null ist).
  • **`true` zurückgeben**true: Das Standard-Places UI-Widget wird unterdrückt.

Im folgenden Beispiel wird gezeigt, wie Sie einen Click Listener festlegen und das Standard-Places UI-Widget unterdrücken, um eine benutzerdefinierte Aktion auszuführen:

googleMap3D.setMap3DClickListener { clickEvent ->
    val location = clickEvent.location
    val placeId = clickEvent.placeId

    // Perform custom action, for example logging or showing a custom tooltip
    showCustomTooltip(location, placeId)

    // Suppress the default Places UI widget by returning true
    true
}