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 den API-Schlüssel Ihrer App hinzu.
4. Fügen Sie die erforderlichen Kennzeichnungen in Ihre App ein.

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

Hinweis: Ihre App muss auf minSdkVersion 23 oder höher ausgerichtet sein.

Mobile App-Projekt einrichten

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

So konfigurieren Sie Ihr App-Projekt:

1. 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 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 und suchen Sie nach dem Maps SDK for Android. Aktivieren Sie es dann.

Driver SDK in Ihre App einbinden

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

Wenn Sie Ihrer App das Driver SDK hinzufügen möchten, fügen Sie Ihrer Gradle- oder Maven-Konfiguration die Abhängigkeiten für das Driver SDK und das Navigation SDK hinzu.

Hinweis :Das Driver SDK ist vom Navigation SDK abhängig. Legen Sie die Abhängigkeit auf eine explizit definierte Version des Navigation SDK fest, wie in diesem Beispiel gezeigt. Andernfalls lassen Sie den Beispielcodeblock weg, damit das Projekt immer die neueste Version des Navigation SDK innerhalb der Hauptversion herunterlädt. Das kombinierte Verhalten der neuesten Versionen des Driver SDK und des Navigation SDK wurde vor der Veröffentlichung strengen Tests unterzogen.

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

Gradle

Fügen Sie zum build.gradle Folgendes hinzu:

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

Maven

Fügen Sie zum pom.xml Folgendes hinzu:

<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>

API-Schlüssel in die App einfügen

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 er von Ihrer App sicherer referenziert werden kann. Weitere Informationen zu den Best Practices für die Sicherheit von API-Schlüsseln finden Sie im Google Maps Platform-Artikel Best Practices für die API-Sicherheit.

Wichtig :Der API-Schlüssel darf nicht in Ihrem Versionskontrollsystem eingecheckt werden. Speichern Sie sie stattdessen in der Datei local.properties, die sich im Stammverzeichnis Ihres Projekts befindet. Weitere Informationen zur Datei local.properties finden Sie unter Gradle-Attributdateien.

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 Element dependencies 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 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 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.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>

Hinweis :Für eine optimale Navigation sollte der Fahrer die folgenden Berechtigungen gewähren: android.permission.ACCESS_COARSE_LOCATION und android.permission.ACCESS_FINE_LOCATION. Sie müssen beide während der Laufzeit in der App anfordern.

Erforderliche Quellenangaben in Ihrer App angeben

Wenn Sie das Driver 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.

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

Weitere Informationen finden Sie unter Hinweise zu Open-Source-Software einfügen.

Nächste Schritte

Abhängigkeiten deklarieren