Le estensioni Kotlin per Android di Maps (KTX) sono una raccolta di estensioni Kotlin per Maps SDK for Android e Maps SDK for Android Utility Library. Queste estensioni offrono funzionalità del linguaggio Kotlin che ti consentono di scrivere codice Kotlin conciso e idiomatico durante lo sviluppo per Maps SDK for Android. Maps KTX è open source e disponibile su GitHub insieme ad alcuni esempi.
Installazione
Per installare KTX per Maps SDK for Android e, facoltativamente, per l'SDK Maps for Android Utility Library, aggiungi le seguenti dipendenze al tuo file build.gradle
.
dependencies {
// KTX for the Maps SDK for Android
implementation 'com.google.maps.android:maps-ktx:3.2.1'
// (Optional) KTX for the Maps SDK for Android Utility Library
implementation 'com.google.maps.android:maps-utils-ktx:3.2.1'
}
Esempi di utilizzo
Con la libreria KTX, puoi sfruttare diverse funzionalità del linguaggio Kotlin, come funzioni di estensione, parametri denominati e argomenti predefiniti, destrutturazione di dichiarazioni e coroutine.
Recupero di una mappa di Google Maps utilizzando le coroutine
L'accesso a GoogleMap
può essere recuperato
utilizzando le coroutine.
lifecycleScope.launchWhenCreated { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() }
Aggiunta di un indicatore
L'aggiunta di un indicatore può essere eseguita con il metodo di stile DSL addMarker()
.
val sydney = LatLng(-33.852, 151.211) val marker = googleMap.addMarker { position(sydney) title("Marker in Sydney") }
Raccolta di eventi della videocamera
Gli eventi, come i movimenti della videocamera, possono essere raccolti tramite Kotlin Flow.
lifecycleScope.launchWhenCreated { googleMap.cameraMoveEvents().collect { print("Received camera move event") } }
Puoi consultare un elenco completo delle funzionalità supportate nella documentazione di riferimento.