Le estensioni Kotlin per Android di Maps (KTX) sono una raccolta di estensioni Kotlin per Maps SDK per Android e Maps SDK for Android Utility Library. Queste estensioni offrono Funzionalità del linguaggio Kotlin che consentono di scrivere Kotlin conciso e idiomatico durante lo sviluppo di Maps SDK for Android. Maps KTX è open source disponibili su GitHub e esempi.
Installazione
Per installare KTX per Maps SDK for Android e, facoltativamente, per Maps SDK per
libreria di utilità Android, aggiungi le seguenti dipendenze a build.gradle.kts
.
dependencies { // KTX for the Maps SDK for Android library implementation("com.google.maps.android:maps-ktx:5.1.1") }
Esempi di utilizzo
Con la libreria KTX, puoi sfruttare diverse lingue come funzioni di estensione, parametri denominati e argomenti predefiniti, dichiarazioni destrutturanti e coroutine.
Recupero di una mappa di Google Maps utilizzando le coroutine
È possibile recuperare l'accesso a una GoogleMap
usando le coroutine.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { 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 effettuata 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 degli eventi della videocamera
Gli eventi, come i movimenti della videocamera, possono essere raccolti tramite Kotlin Flow.
lifecycleScope.launch { lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) { googleMap.cameraMoveEvents().collect { print("Received camera move event") } } }
Per un elenco completo delle funzioni supportate, consulta il documentazione di riferimento.
Prova l'applicazione di esempio
Il repository GitHub per questa libreria contiene anche un'applicazione demo che mostra come utilizzare la libreria KTX di Maps nella tua app.
Per provare l'applicazione demo, segui questi passaggi:
- Da GitHub, clona o scarica il file ZIP.
- In Android Studio, scegli File -> Apri, passa alla directory e apri la cartella che hai appena clonato o scaricato.
- Aggiungi una chiave API all'app demo.
- Ottieni una chiave Maps SDK for Android.
- Nella directory root, crea un file denominato
secrets.properties
. Questo file NON deve essere sottoposto al controllo della versione per proteggere la tua chiave API. - Aggiungi questa singola riga a
secrets.properties
MAPS_API_KEY="YOUR_API_KEY"
doveYOUR_API_KEY
è l'effettiva chiave API che hai ottenuto nel primo passaggio. Puoi dare un'occhiata allesecrets.defaults.properties
come esempio. - Sotto la configurazione di esecuzione, seleziona il modulo app-ktx.
- Seleziona Esegui 'app-ktx'.
Passaggi successivi
Ti potrebbero interessare anche altre librerie di estensioni Kotlin per Google Maps Piattaforma: