Maps Android KTX

Les extensions Kotlin (KTX) de Maps Android sont un ensemble d'extensions Kotlin destiné au SDK Maps pour Android et à la bibliothèque d'utilitaires du SDK Maps pour Android. Ces extensions fournissent des fonctionnalités en langage Kotlin qui vous permettent d'écrire du code Kotlin concis et idiomatique lorsque vous développez du contenu pour le SDK Maps pour Android. Maps KTX est disponible en Open Source sur GitHub, où vous trouverez également des exemples.

Installation

Pour installer KTX pour le SDK Maps pour Android, et, si vous le souhaitez, pour la bibliothèque d'utilitaires du SDK Maps pour Android, ajoutez les dépendances suivantes à votre fichier 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'
}

Exemples d'utilisation

Avec la bibliothèque KTX, vous pouvez bénéficier de plusieurs fonctionnalités du langage Kotlin, comme les fonctions d'extension, les paramètres nommés et les arguments par défaut, ainsi que les déclarations de déstructuration et les coroutines.

Récupérer une GoogleMap à l'aide de coroutines

Vous pouvez accéder à une GoogleMap à l'aide de coroutines.

lifecycleScope.launchWhenCreated {
  val mapFragment: SupportMapFragment? =
    supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
  val googleMap: GoogleMap? = mapFragment?.awaitMap()
}

Ajouter un repère

Pour ajouter un repère, vous pouvez utiliser la méthode DSL addMarker().

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

Collecter des événements liés à la caméra

Les événements comme les mouvements de caméra peuvent être collectés avec Kotlin Flow.

lifecycleScope.launchWhenCreated {
  googleMap.cameraMoveEvents().collect {
    print("Received camera move event")
  }
}

Pour obtenir la liste complète des fonctionnalités compatibles, consultez les documents de référence.