Android Studio-Projekt einrichten

So konfigurieren Sie Ihre App für die Verwendung des Places SDK for Android: Sie sind für alle Apps erforderlich, in denen das Places SDK for Android verwendet wird.

Schritt 1: Android Studio einrichten

  1. Android Studio Arctic Fox oder höher ist erforderlich. Falls noch nicht geschehen, müssen Sie diese Version von Android Studio herunterladen und installieren.
  2. Es muss mindestens Version 7.0 des Android-Gradle-Plug-ins in Android Studio verwendet werden.

Schritt 2: SDK einrichten

Die Places SDK for Android-Bibliothek ist über das Maven-Repository von Google verfügbar. So fügen Sie das SDK der App hinzu:

  1. Fügen Sie in der Datei settings.gradle auf oberster Ebene das Portal für Gradle-Plug-ins, das Maven-Repository von Google und das Maven Central Repository unter dem pluginManagement-Block ein. Der pluginManagement-Block muss vor allen anderen Anweisungen im Skript eingefügt werden.
    pluginManagement {
        repositories {
            gradlePluginPortal()
            google()
            mavenCentral()
        }
    } 
  2. Fügen Sie in der Datei settings.gradle auf oberster Ebene das Maven-Repository von Google und das Maven Central Repository unter dem dependencyResolutionManagement-Block ein:
    dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
            google()
            mavenCentral()
        }
    } 
  3. Fügen Sie im Abschnitt dependencies der Datei build.gradle auf Modulebene eine Abhängigkeit in das Places SDK for Android ein:

    dependencies {
        implementation 'com.google.android.libraries.places:places:3.0.0'
    }
    
  4. Legen Sie in der Datei build.gradle auf Modulebene für compileSdk und minSdk die folgenden Werte fest:
    android {
        compileSdk 31
    
        defaultConfig {
            minSdk 21
            // ...
        }

Schritt 3: API-Schlüssel zum Projekt hinzufügen

In diesem Abschnitt wird beschrieben, wie Sie Ihren API-Schlüssel speichern, damit er von Ihrer App sicherer referenziert werden kann. Er sollte nicht in Ihrem Versionsverwaltungssystem eingecheckt werden. Stattdessen empfehlen wir Ihnen, ihn im Stammverzeichnis Ihres Projekts in der Datei local.properties zu speichern. Weitere Informationen zur Datei local.properties finden Sie unter Gradle properties files (nur in englischer Sprache verfügbar).

Sie können das Secrets Gradle Plugin for Android verwenden, um diese Aufgabe zu optimieren. So installieren Sie das Plug-in und speichern Ihren API-Schlüssel:

  1. Öffnen Sie in Android Studio die Datei build.gradle auf Projektebene und fügen Sie folgenden Code in das Element dependencies unter buildscript ein:
    plugins {
        // ...
        id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin' version '2.0.1' apply false
    }
  2. Öffnen Sie dann die Datei build.gradle auf Modulebene und fügen Sie dem Element plugins den folgenden Code hinzu:
    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
        
  3. Speichern Sie die Datei und synchronisieren Sie Ihr Projekt mit Gradle.
  4. Öffnen Sie die Datei local.properties in Ihrem Verzeichnis auf Projektebene, fügen Sie den folgenden Code ein und ersetzen Sie dabei YOUR_API_KEY durch Ihren eigenen API-Schlüssel:
    MAPS_API_KEY=YOUR_API_KEY
        
  5. Speichern Sie die Datei.
  6. Rufen Sie in der Datei AndroidManifest.xml com.google.android.geo.API_KEY auf und aktualisieren Sie android:value attribute so:
    <meta-data
        android:name="com.google.android.geo.API_KEY"
        android:value="${MAPS_API_KEY}" />
        

Hinweis: Für den API-Schlüssel wird com.google.android.geo.API_KEY als Metadatenname empfohlen (siehe oben). Ein Schlüssel mit diesem Namen kann zur Authentifizierung bei mehreren Google Maps-basierten APIs auf der Android-Plattform verwendet werden, einschließlich des Places SDK for Android. Aus Gründen der Abwärtskompatibilität unterstützt die API auch den Namen com.google.android.maps.v2.API_KEY. Für diesen alten Namen wird nur die Authentifizierung bei Version 2 der Android Maps API unterstützt. In der Anwendung kann nur einer der Metadatennamen für den API-Schlüssel festgelegt werden. Falls beide angegeben werden, gibt die API eine Ausnahme aus.

Schritt 4: Places API-Client initialisieren

Initialisieren Sie das Places SDK for Android innerhalb einer Aktivität oder eines Fragments wie im folgenden Beispiel. Der API-Schlüssel muss beim Aufruf von Places.initialize() übergeben werden:

Java


    // Initialize the SDK
    Places.initialize(getApplicationContext(), apiKey);

    // Create a new PlacesClient instance
    PlacesClient placesClient = Places.createClient(this);

      

Kotlin


    // Initialize the SDK
    Places.initialize(applicationContext, apiKey)

    // Create a new PlacesClient instance
    val placesClient = Places.createClient(this)

      

Sie können das Places SDK for Android jetzt verwenden.

Schritt 5: Android-Gerät einrichten

Wenn Sie eine App ausführen möchten, die das Places SDK for Android verwendet, müssen Sie sie auf einem Android-Gerät oder einem Android-Emulator bereitstellen, das auf Android 4.0 oder höher basiert und die Google APIs enthält.

  • Wenn du ein Android-Gerät verwenden möchtest, folge der Anleitung zum Ausführen von Apps auf einem Hardwaregerät (in englischer Sprache).
  • Wenn Sie einen Android Emulator verwenden möchten, können Sie ein virtuelles Gerät erstellen und den Emulator mit dem AVD Manager für virtuelle Android-Geräte installieren, der in Android Studio enthalten ist.

Nächste Schritte

Nachdem Ihr Projekt konfiguriert wurde, können Sie sich die Beispiel-Apps ansehen.