Places Android KTX – Übersicht und Einrichtung

Places Android KTX ist eine Sammlung von Kotlin-Erweiterungen für das Places SDK for Android. Mit den Kotlin-Sprachfunktionen dieser Erweiterungen können Sie bei der Entwicklung für das Places SDK for Android prägnanten und idiomatischen Kotlin-Code schreiben. Places KTX ist eine Open-Source-Bibliothek und mit entsprechenden Beispielen auf GitHub verfügbar.

KTX für das Places SDK installieren

Fügen Sie die folgenden Abhängigkeiten in die build.gradle.kts-Datei auf App-Ebene ein, um KTX für das Places SDK for Android zu installieren.

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

Beispiel-App ausprobieren

Das GitHub-Repository für diese Bibliothek enthält auch eine Demo-App, die zeigt, wie Sie die Places KTX-Bibliothek in Ihrer App verwenden können.

Erster Bildschirm der Places KTX-Beispiel-App mit den Auswahlmöglichkeiten
Bildschirm der Places Search-Demo-App

Gehen Sie folgendermaßen vor, um die Demo-App auszuprobieren:

  1. Klonen Sie die ZIP-Datei aus GitHub oder laden Sie sie herunter.
  2. Wählen Sie in Android Studio File -> Open aus und öffnen Sie im Verzeichnis den Ordner, den Sie gerade geklont oder heruntergeladen haben.
  3. Fügen Sie der Demo-App einen API-Schlüssel hinzu.
    1. Places API-Schlüssel anfordern
    2. Erstellen Sie im Stammverzeichnis eine Datei mit dem Namen secrets.properties. Zum Schutz Ihres API-Schlüssels sollte diese Datei NICHT der Versionsverwaltung unterliegen.
    3. Fügen Sie diese einzelne Zeile zu secrets.properties
      hinzu. 
      PLACES_API_KEY="YOUR_API_KEY"
       Dabei ist YOUR_API_KEY der API-Schlüssel, den Sie im ersten Schritt erhalten haben. Sie können sich local.defaults.properties als Beispiel ansehen.
  4. Wählen Sie unter der Ausführungskonfiguration das Modul app-places-ktx aus.
  5. Wählen Sie Run 'app-places-ktx' ('app-places-ktx' ausführen) aus.