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 {

    // KTX for the Places SDK for Android library
    implementation("com.google.maps.android:places-ktx:3.2.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 Ihren Auswahlmöglichkeiten
Demobildschirm der Places Search 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 (Datei) -> Open (Öffnen) 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. Fordern Sie einen Places API-Schlüssel an.
    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 secrets.properties
      diese einzelne Zeile hinzu: 
      PLACES_API_KEY="YOUR_API_KEY"
       wobei YOUR_API_KEY der API-Schlüssel ist, 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.