Google Cloud Console-Projekt konfigurieren

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

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

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 unter Projekt erstellen in der Fleet Engine-Anleitung.

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

Fügen Sie Ihrer App das Consumer SDK hinzu.

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

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

Gradle

Fügen Sie 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 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>

Fügen Sie Ihrer App den API-Schlüssel hinzu.

Nachdem Sie Ihrer App das Consumer SDK hinzugefü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 unter Entwicklungsprojekt einrichten in Schritt 3 dieser Anleitung.

In diesem Abschnitt wird beschrieben, wie Sie Ihren API-Schlüssel speichern, damit Ihre App sicherer darauf verweisen 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 das GitHub-Dokument 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 die Datei build.gradle auf Stammebene und fügen Sie dem Element dependencies 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 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 im Verzeichnis auf Projektebene und fügen Sie den folgenden Code hinzu. Ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel.

    MAPS_API_KEY=YOUR_API_KEY

  5. Suchen Sie in der Datei AndroidManifest.xml nach 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>

Fügen Sie Ihrer App die erforderlichen Quellenangaben hinzu.

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

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

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

Nächste Schritte

Authentifizierungstokens abrufen