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. Les extensions Maps KTX sont disponibles en Open Source sur GitHub, où vous trouverez également des exemples.

Installation

Pour installer les 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 library
    implementation 'com.google.maps.android:maps-ktx:5.0.0'
}

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.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    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.launch {
  lifecycle.repeatOnLifecycle(Lifecycle.State.CREATED) {
    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.

Essayer l'exemple d'application

Le dépôt GitHub pour cette bibliothèque inclut également une application de démonstration qui montre comment utiliser la bibliothèque Maps KTX dans votre propre application.

Pour essayer l'application de démonstration :

  1. Depuis GitHub, clonez ou téléchargez le fichier ZIP.
  2. Dans Android Studio, sélectionnez File > Open (Fichier > Ouvrir), puis accédez au répertoire et ouvrez le dossier que vous venez de cloner ou de télécharger.
  3. Ajoutez une clé API à l'application de démonstration.
    1. Obtenez une clé SDK Maps pour Android.
    2. Dans le répertoire racine, créez un fichier nommé secrets.properties. Pour protéger votre clé API, ce fichier ne doit PAS être soumis au contrôle des versions.
    3. Ajoutez cette ligne unique à secrets.properties
      MAPS_API_KEY="YOUR_API_KEY"
      YOUR_API_KEY est la clé API que vous avez obtenue à la première étape. Vous pouvez examiner secrets.defaults.properties à titre d'exemple.
  4. Sous la configuration d'exécution, sélectionnez le module app-ktx.
  5. Sélectionnez Run 'app-ktx' (Exécuter "app-ktx").

Étapes suivantes

Vous êtes peut-être aussi intéressé par d'autres bibliothèques d'extensions Kotlin pour Google Maps Platform :

  • KTX pour la bibliothèque d'utilitaires du SDK Maps pour Android
  • KTX pour le SDK Places pour Android