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:
- Modalità altitudine: chiama
setAltitudeModesuMarkerViewOptionscon una costanteAltitudeMode. Per impostazione predefinita,MarkerViewOptionsutilizzaAltitudeMode.CLAMP_TO_GROUND. - Comportamento della sovrapposizione: chiama
setCollisionBehaviorcon una costanteCollisionBehavior(il valore predefinito èCollisionBehavior.REQUIRED) e utilizzasetCollisionPriorityper specificare la priorità di visualizzazione in caso di sovrapposizione degli indicatori.
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()