Maps per Android KTX

Le estensioni Kotlin per Android (KTX) di Maps sono una raccolta di estensioni Kotlin per Maps SDK for Android e la libreria di utilità di Maps SDK for Android. Queste estensioni forniscono funzionalità del linguaggio Kotlin che ti consentono di scrivere Kotlin conciso e idiomatico durante lo sviluppo per Maps SDK for Android. Maps KTX è open source ed è disponibile su GitHub insieme a esempi.

Installazione

Per installare KTX per Maps SDK for Android e, facoltativamente, per la libreria di utilità di Maps SDK for Android, aggiungi le seguenti dipendenze al tuo file 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 funzionalità del linguaggio Kotlin, come funzioni di estensione, parametri denominati e argomenti predefiniti, dichiarazioni di destrutturazione e coroutine.

Recupero di una mappa Google utilizzando le coroutine

L'accesso a un GoogleMap può essere recuperato utilizzando 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 eseguita utilizzando il metodo in stile DSL addMarker().

val sydney = LatLng(-33.852, 151.211)
val marker = googleMap.addMarker {
  position(sydney)
  title("Marker in Sydney")
}

Raccogliere gli 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")
    }
  }
}

Puoi visualizzare un elenco completo delle funzionalità supportate leggendo la documentazione di riferimento.

Prova l'applicazione di esempio

Il repository GitHub di questa libreria contiene anche un'applicazione demo che mostra come utilizzare la libreria Maps KTX nella tua app.

Per provare l'applicazione di dimostrazione:

1. Da GitHub, clona o scarica il file ZIP.
2. In Android Studio, scegli File -> Apri, vai alla directory e apri la cartella appena clonata o scaricata.
3. Aggiungi una chiave API all'app di demo.
1. Ottieni una chiave Maps SDK for Android.
2. Nella directory principale, crea un file denominato secrets.properties. Per proteggere la tua chiave API, questo file NON deve essere sottoposto a controllo delle versioni.
3. Aggiungi questa singola riga a secrets.properties
   

   MAPS_API_KEY="YOUR_API_KEY"

   dove YOUR_API_KEY è la chiave API effettiva ottenuta nel primo passaggio. Puoi consultare secrets.defaults.properties come esempio.
4. Nella configurazione di esecuzione, seleziona il modulo app-ktx.
5. Seleziona Esegui "app-ktx".

Passaggi successivi

Potrebbero interessarti anche altre librerie di estensioni Kotlin per Google Maps Platform:

• KTX per la libreria di utilità di Maps SDK for Android
• KTX per l'SDK Places per Android