Google Cloud Console-Projekt konfigurieren

So richten Sie ein Google Cloud Console-Projekt ein und konfigurieren es für die Verwendung des Driver SDK for Android:

1. Richten Sie Ihr Projekt für mobile Apps ein.
2. Fügen Sie Ihrer App das Driver 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.

Projekt für mobile Apps einrichten

In diesem Abschnitt wird beschrieben, wie Sie Ihr Projekt für mobile Apps für das Driver SDK konfigurieren.

So konfigurieren Sie Ihr Projekt für mobile Apps:

1. 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 Fleet Engine-Projekt erstellen.
2. Wählen Sie in der Google Cloud Console dasselbe Google Cloud Console-Projekt und denselben API-Schlüssel aus, die Sie für Fleet Engine verwenden.
3. Wählen Sie APIs und Dienste aus, suchen Sie nach dem Maps SDK for Android und aktivieren Sie es.

Fügen Sie Ihrer App das Driver SDK hinzu.

Das Driver SDK ist im Google Maven-Repository verfügbar. Das Repository enthält die Projektobjektmodelldateien (.pom) und die Javadocs des SDK.

Fügen Sie Ihrer App das Driver SDK hinzu, indem Sie die Abhängigkeiten des Driver SDK und des Navigation SDK zu Ihrer Gradle- oder Maven-Konfiguration hinzufügen.

Ersetzen Sie im folgenden Beispiel VERSION_NUMBER durch die ausgewählte Version des Driver SDK.

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

Nachdem Sie Ihrer App das Driver 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 unter Projekt für mobile Apps einrichten.

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 Secrets Gradle Plugin for Android aus der GitHub-Dokumentation 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 unter Projekt mit Gradle synchronisieren.

4. Öffnen Sie die Datei local.properties in Ihrem 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.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_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 Driver SDK in Ihrer App verwenden, müssen Sie Quellenangaben und Open-Source-Lizenzen in den Bereich mit den rechtlichen Hinweisen Ihrer App einfügen. 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 Einfügen von Open-Source-Hinweisen finden Sie unter Open-Source-Hinweise einfügen unter Open-Source-Hinweise einfügen.

Nächste Schritte

Abhängigkeiten deklarieren