Google Cloud Console-Projekt konfigurieren

So richten Sie eine Google Cloud Console für die Verwendung des Consumer SDK für Android ein und konfigurieren sie:

  1. Entwicklungsprojekt einrichten
  2. Fügen Sie Ihrer App das Consumer SDK hinzu.
  3. Fügen Sie den API-Schlüssel in Ihre App ein.
  4. Fügen Sie die erforderlichen Quellenangaben in Ihre App ein.

Weitere Informationen zu den einzelnen Schritten finden Sie in den folgenden Abschnitten.

Entwicklungsprojekt einrichten

Wenn Sie noch kein Google Cloud Console-Entwicklungsprojekt und keinen API-Schlüssel für Ihr Mobilitätsprojekt haben, müssen Sie diese einrichten. Weitere Informationen finden Sie im Fleet Engine-Leitfaden unter Projekt erstellen.

Wenn Sie Ihr Entwicklungsprojekt für das Consumer SDK auswählen, verwenden Sie dasselbe Google Cloud Console-Projekt und denselben API-Schlüssel, die Sie für Fleet Engine verwenden.

Consumer SDK in Ihre App einbinden

Das Consumer SDK ist im Google Maven-Repository verfügbar. Das Repository enthält die POM-Dateien (.pom) und Javadocs des SDK. Wenn Sie das Consumer SDK in Ihre App einfügen möchten, fügen Sie die Consumer SDK- und Maps SDK-Abhängigkeiten in Ihre Gradle- oder Maven-Konfiguration ein.

Ersetzen Sie in den folgenden Beispielen VERSION_NUMBER durch die erforderliche Version des Consumer SDK:

Gradle

Fügen Sie zum build.gradle Folgendes hinzu:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

Fügen Sie zum pom.xml Folgendes hinzu:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

API-Schlüssel in die App einfügen

Nachdem Sie das Consumer SDK in Ihre App eingefügt haben, fügen Sie den API-Schlüssel hinzu. Sie müssen den API-Schlüssel des Projekts verwenden, den Sie beim Einrichten Ihres Entwicklungsprojekts erhalten haben. Weitere Informationen finden Sie in Schritt 3 dieses Leitfadens unter Entwicklungsprojekt einrichten.

In diesem Abschnitt wird beschrieben, wie Sie Ihren API-Schlüssel speichern, damit er von Ihrer App sicherer referenziert werden kann. Weitere Informationen zu den Best Practices für die API-Schlüsselsicherheit finden Sie im Google Maps Platform-Artikel Best Practices für die API-Sicherheit.

Sie können die GitHub-Dokumentation zum Secrets Gradle-Plug-in für Android verwenden, um diese Aufgabe zu optimieren.

So installieren Sie das Plug-in und speichern Ihren API-Schlüssel:

  1. Öffnen Sie die Datei build.gradle auf Stammebene und fügen Sie den folgenden Code in das dependencies-Element unter buildscript ein.

    Groovy

    buildscript {
      dependencies {
          // ...
          classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
      }
}

    Kotlin

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
    }
}

  2. Öffnen Sie die Datei build.gradle auf App-Ebene und fügen Sie dem Element plugins den folgenden Code hinzu.

    Groovy

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Wenn Sie Android Studio verwenden, synchronisieren Sie Ihr Projekt mit Gradle. Weitere Informationen finden Sie in der Android-Dokumentation unter Projekt mit Gradle synchronisieren.

  4. Öffnen Sie die Datei local.properties in Ihrem Verzeichnis auf Projektebene und fügen Sie den folgenden Code ein. Ersetzen Sie dabei YOUR_API_KEY durch Ihren eigenen API-Schlüssel.

    MAPS_API_KEY=YOUR_API_KEY

  5. Gehen Sie in der Datei AndroidManifest.xml zu com.google.android.geo.API_KEY und aktualisieren Sie das Attribut android:value so:

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

Das folgende Beispiel zeigt ein vollständiges Manifest für eine Beispiel-App:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme">

            <meta-data
                android:name="com.google.android.geo.API_KEY"
                android:value="${MAPS_API_KEY}" />

            <activity android:name=".MainActivity">
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

Erforderliche Quellenangaben in Ihre App einfügen

Wenn Sie das Consumer SDK in Ihrer App verwenden, müssen Sie Quellenangaben und Open-Source-Lizenzen in den Bereich mit den rechtlichen Hinweisen Ihrer App aufnehmen. Am besten fügen Sie die Quellenangaben als separaten Menüpunkt oder im Menüpunkt Info ein.

Die Lizenzinformationen finden Sie in der Datei „third_party_licenses.txt“ in der nicht archivierten AAR-Datei.

Informationen zum Einbinden von Open-Source-Hinweisen finden Sie unter https://developers.google.com/android/guides/opensource.

Nächste Schritte

Authentifizierungstokens abrufen