So richten Sie die Google Cloud Console für die Verwendung des Consumer SDK für Android ein und konfigurieren sie:
- Richten Sie Ihr Entwicklungsprojekt ein.
- Fügen Sie Ihrer App das Consumer SDK hinzu.
- Fügen Sie den API-Schlüssel Ihrer App hinzu.
- Fügen Sie die erforderlichen Kennzeichnungen 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 unter Projekt erstellen im Fleet Engine-Leitfaden.
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 in Ihre App einbinden
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:
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 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 bei der Einrichtung 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 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 Secrets Gradle-Plugin for Android verwenden, um diese Aufgabe zu optimieren.
So installieren Sie das Plug-in und speichern Ihren API-Schlüssel:
Öffnen Sie die Datei
build.gradle
auf Stammebene und fügen Sie den folgenden Code in das Elementdependencies
unterbuildscript
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") } }
Öffnen Sie die Datei
build.gradle
auf App-Ebene und fügen Sie dem Elementplugins
den folgenden Code hinzu.Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Wenn Sie Android Studio verwenden, synchronisieren Sie Ihr Projekt mit Gradle. Weitere Informationen finden Sie in der Android-Dokumentation unter Projekt mit Gradle synchronisieren.
Öffnen Sie die Datei
local.properties
in Ihrem Verzeichnis auf Projektebene und fügen Sie den folgenden Code ein. Ersetzen Sie dabeiYOUR_API_KEY
durch Ihren eigenen API-Schlüssel.MAPS_API_KEY=YOUR_API_KEY
Gehen Sie in der Datei
AndroidManifest.xml
zucom.google.android.geo.API_KEY
und aktualisieren Sie das Attributandroid: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 Ihrer App angeben
Wenn Sie das Consumer SDK in Ihrer App verwenden, müssen Sie Quellenangaben und Open-Source-Lizenzen in den Abschnitt mit den rechtlichen Hinweisen Ihrer App aufnehmen. Am besten geben Sie die Quellenangaben als eigenen Menüpunkt oder im Menü Info an.
Sie finden die Lizenzinformationen in der Datei „third_party_Licenses.txt“ in der wieder aktivierten AAR-Datei.
Weitere Informationen zur Einbindung von Open-Source-Hinweisen finden Sie unter https://developers.google.com/android/guides/opensource.