Creare indicatori con visualizzazioni personalizzate

Immagine 3D di New York con l'Empire State Building e tre indicatori digitali personalizzati che fluttuano sopra, tra cui un gorilla in stile cartone animato con l'etichetta

Puoi utilizzare MarkerView per eseguire il rendering di gerarchie View Android personalizzate come indicatori su una mappa 3D. I marker di visualizzazione personalizzati ti consentono di mostrare layout UI avanzati, widget interattivi e animazioni di visualizzazione ancorati alle coordinate geografiche.

Aggiungi un indicatore di visualizzazione personalizzata

Per aggiungere un indicatore di visualizzazione personalizzata alla mappa, crea un'istanza MarkerViewOptions, configura la sua posizione con setPosition utilizzando un oggetto LatLngAltitude e fornisci l'oggetto View Android personalizzato utilizzando setContent. Quindi, passa le opzioni a addMarkerView sulla tua istanza GoogleMap3D.

Se non fornisci una visualizzazione a setContent, l'SDK crea ed esegue il rendering di un PinView predefinito.

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

Personalizza la visualizzazione dei punti di interesse predefinita

Anziché creare un View Android completamente personalizzato, puoi eseguire il rendering di un segnaposto personalizzato creando un PinView con un PinConfiguration personalizzato (o aggiornando un'istanza esistente con setPinConfiguration) e passandolo a setContent.

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

Gestisci interazioni e animazioni

Poiché un MarkerView racchiude un View Android, puoi collegare click listener standard e visualizzare le animazioni direttamente nella visualizzazione restituita da getContent.

Inoltre, MarkerView implementa Anchorable, che ti consente di ancorare un Popover alla visualizzazione del marker utilizzando addPopover:

markerView?.content?.setOnClickListener { view ->
    // Animate the view when clicked
    view.animate().rotationBy(90f).setDuration(300).start()
}

Configura l'altitudine e il comportamento della sovrapposizione

Puoi personalizzare il modo in cui un MarkerView viene posizionato verticalmente e il modo in cui interagisce con etichette o indicatori della mappa sovrapposti:

Accessibilità e rimozione

Sei responsabile della configurazione delle proprietà di accessibilità, come contentDescription, sull'oggetto View Android personalizzato fornito a setContent.

Per rimuovere un MarkerView dalla mappa, chiama remove:

markerView?.remove()