Markierungen mit benutzerdefinierten Ansichten erstellen

3D-Bild von New York City mit dem Empire State Building und drei benutzerdefinierten digitalen Markierungen, die darüber schweben, darunter ein Cartoon-Gorilla mit der Beschriftung

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:

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