Mit MarkerView können Sie benutzerdefinierte Android-View-Hierarchien als Markierungen auf einer 3D-Karte rendern. Mit benutzerdefinierten Ansichtsmarkierungen können Sie umfangreiche UI-Layouts, interaktive Widgets und Ansichtsanimationen anzeigen, die an geografischen Koordinaten verankert sind.
Benutzerdefinierte Ansichtsmarkierung hinzufügen
Wenn Sie Ihrer Karte eine Markierung mit benutzerdefinierter Ansicht hinzufügen möchten, erstellen Sie eine MarkerViewOptions-Instanz, konfigurieren Sie ihre Position mit setPosition mithilfe eines LatLngAltitude-Objekts und geben Sie Ihre benutzerdefinierte Android-View mit setContent an.
Übergeben Sie die Optionen dann an addMarkerView in Ihrer GoogleMap3D-Instanz.
Wenn Sie keine Ansicht für setContent angeben, erstellt das SDK eine Standard-PinView und rendert sie.
// Add imports
import android.widget.TextView
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.latLngAltitude
// Create a custom Android View
val badgeView = TextView(context).apply {
text = "Empire State Building"
contentDescription = "Marker for Empire State Building"
setPadding(24, 12, 24, 12)
}
// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
position = latLngAltitude {
latitude = 40.7484
longitude = -73.9857
altitude = 100.0
}
content = badgeView
}
val markerView = googleMap3D.addMarkerView(options)
Standard-PinView anpassen
Anstatt ein komplett benutzerdefiniertes View-Objekt für Android zu erstellen, können Sie eine benutzerdefinierte Markierung rendern, indem Sie ein PinView-Objekt mit einem benutzerdefinierten PinConfiguration-Objekt erstellen (oder eine vorhandene Instanz mit setPinConfiguration aktualisieren) und an setContent übergeben.
// Add imports
import android.graphics.Color
import com.google.android.gms.maps3d.model.MarkerViewOptions
import com.google.android.gms.maps3d.model.PinView
import com.google.android.gms.maps3d.model.latLngAltitude
import com.google.android.gms.maps3d.model.pinConfiguration
// Create a customized PinView
val customPinView = PinView(context, pinConfiguration {
backgroundColor = Color.BLUE
borderColor = Color.WHITE
})
// Configure MarkerViewOptions and add the marker view to the map
val options = MarkerViewOptions().apply {
position = latLngAltitude {
latitude = 40.7484
longitude = -73.9857
altitude = 100.0
}
content = customPinView
}
val markerView = googleMap3D.addMarkerView(options)
Interaktionen und Animationen verwalten
Da ein MarkerView ein Android-View umschließt, können Sie Standard-Klick-Listener und Ansichtsanimationen direkt an die von getContent zurückgegebene Ansicht anhängen.
Außerdem implementiert MarkerView Anchorable, sodass Sie mit addPopover ein Popover in der Markierungsansicht verankern können:
markerView?.content?.setOnClickListener { view ->
// Animate the view when clicked
view.animate().rotationBy(90f).setDuration(300).start()
}
Höhe und Konfliktverhalten konfigurieren
Sie können die vertikale Position eines MarkerView-Objekts und seine Interaktion mit überlappenden Kartenlabels oder Markierungen anpassen:
- Höhenmodus: Rufen Sie
setAltitudeModefürMarkerViewOptionsmit einerAltitudeMode-Konstante auf. Standardmäßig verwendetMarkerViewOptionsAltitudeMode.CLAMP_TO_GROUND. - Konfliktverhalten: Rufen Sie
setCollisionBehaviormit einerCollisionBehavior-Konstante auf (Standardwert istCollisionBehavior.REQUIRED) und verwenden SiesetCollisionPriority, um die Anzeigepriorität bei Konflikten zwischen Markierungen anzugeben.
Zugänglichkeit und Entfernung
Sie sind für die Konfiguration der Eigenschaften für die Barrierefreiheit im Internet verantwortlich, z. B. contentDescription, auf der benutzerdefinierten Android-View, die für setContent bereitgestellt wird.
Wenn Sie ein MarkerView von der Karte entfernen möchten, rufen Sie remove auf:
markerView?.remove()