Le estensioni di Kotlin per Android (KTX) sono una raccolta di estensioni Kotlin per Maps SDK for Android e Maps SDK for Android Utility Library. Queste estensioni forniscono funzionalità del linguaggio Kotlin che ti consentono di scrivere un Kotlin conciso e idiomatico durante lo sviluppo dell'SDK di Maps per Android. Maps KTX è open source ed è disponibile su GitHub insieme a esempi.
Installazione
Per installare KTX per Maps SDK for Android e, facoltativamente, per Maps SDK for Android Utility Library, aggiungi le seguenti dipendenze al 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 quali funzioni di estensione, parametri denominati e argomenti predefiniti, dichiarazioni di strutturazione e coroutine.
Recupero di una mappa Google utilizzando coroutine
È possibile recuperare un GoogleMap
utilizzando
le colonne corrispondenti.
lifecycleScope.launchWhenCreated { val mapFragment: SupportMapFragment? = supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment val googleMap: GoogleMap? = mapFragment?.awaitMap() }
Aggiungere un indicatore
È possibile aggiungere un indicatore utilizzando 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 in corso...
Gli eventi, ad esempio gli spostamenti della videocamera, possono essere raccolti tramite Kotlin Flow.
lifecycleScope.launchWhenCreated { googleMap.cameraMoveEvents().collect { print("Received camera move event") } }
Per un elenco completo delle funzionalità supportate, leggi la documentazione di riferimento.