Google Cloud Console-Projekt konfigurieren

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

1. Richten Sie Ihr Entwicklungsprojekt ein.
2. Fügen Sie Ihrer App das Consumer SDK hinzu.
3. Fügen Sie den API-Schlüssel Ihrer App hinzu.
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 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.

Wählen Sie beim Auswählen Ihres Entwicklungsprojekts für das Consumer SDK dasselbe Google Cloud Console-Projekt und denselben API-Schlüssel aus, die Sie für die Fleet Engine verwenden.

Consumer SDK zur App hinzufügen

Das Consumer SDK ist im Google Maven-Repository verfügbar. Das Repository enthält die Projektobjektmodelldateien (.pom) und Javadocs des SDKs. Wenn Sie Ihrer App das Consumer SDK hinzufügen möchten, fügen Sie Ihrer Gradle- oder Maven-Konfiguration die Abhängigkeiten des Consumer SDK und des Maps SDK hinzu.

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

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

<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 Ihrer App das Consumer SDK hinzugefügt haben, fügen Sie den API-Schlüssel hinzu. Sie müssen den Projekt-API-Schlüssel verwenden, den Sie beim Einrichten Ihres Entwicklungsprojekts erhalten haben. Weitere Informationen finden Sie in Schritt 3 dieser Anleitung 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 Best Practices für die Sicherheit von API-Schlüsseln 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 build.gradle-Datei auf Stammebene und fügen Sie dem dependencies-Element unter buildscript den folgenden Code hinzu.

   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 plugins-Element 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 im Verzeichnis auf Projektebene und fügen Sie den folgenden Code hinzu. 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 nehmen Sie folgende Änderungen am Attribut android:value vor:

        <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 Ihrer App angeben

Wenn Sie das Consumer SDK in Ihrer App verwenden, müssen Sie im Abschnitt mit den rechtlichen Hinweisen Ihrer App einen Quellenhinweis und Open-Source-Lizenzen angeben. Fügen Sie die Quellenangaben am besten als eigenständigen Menüpunkt oder als Teil eines Menüpunkts Info hinzu.

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

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

Nächste Schritte

Authentifizierungstokens abrufen