Présentation et configuration de Places Android KTX

Places Android KTX est un ensemble d'extensions Kotlin pour le SDK Places 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 Places pour Android. Places KTX est disponible en Open Source sur GitHub, où vous trouverez également des exemples.

Installer KTX pour le SDK Places

Pour installer KTX pour le SDK Places pour Android, ajoutez les dépendances suivantes à votre fichier build.gradle.kts au niveau de l'application.

dependencies {

    // Modern Android projects use version catalogs to manage dependencies. To include the Places SDK for Android,
    // first add the following to your gradle/libs.versions.toml file:
    //
    // [versions]
    // places = "5.3.0"
    //
    // [libraries]
    // places = { group = "com.google.android.libraries.places", name = "places", version.ref = "places" }
    //
    // Places SDK for Android (Kotlin extensions and coroutines are built directly into the Places SDK)
    implementation(libs.places)

    // If your project does not use a version catalog, you can use the following dependency instead:
    //
    //    implementation("com.google.android.libraries.places:places:5.3.0")
}

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 Places KTX dans votre propre application.

Premier écran de l'application exemple Places KTX, montrant vos choix
Écran de l'application de démonstration Places Search

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é API Places.
    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 à secrets.properties
      PLACES_API_KEY="YOUR_API_KEY"
      YOUR_API_KEY est la clé API que vous avez obtenue à la première étape. Vous pouvez examiner local.defaults.properties à titre d'exemple.
  4. Sous la configuration d'exécution, sélectionnez le module app-places-ktx.
  5. Sélectionnez Run 'app-places-ktx' (Exécuter "app-places-ktx").