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 eine mobile App ein.
  2. Fügen Sie Ihrer App das Treiber-SDK hinzu.
  3. Fügen Sie Ihrer App den API-Schlüssel hinzu.
  4. Binden Sie die erforderlichen Quellenangaben in Ihre App ein.

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

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 haben für Ihr Mobilitätsprojekt benötigen, müssen Sie eines einrichten. Weitere Informationen finden Sie unter Erstellen Sie Ihr Fleet Engine-Projekt.
  2. Wählen Sie in der Google Cloud Console dasselbe Google Cloud Console-Projekt aus und API-Schlüssel, den Sie für Fleet Engine verwenden.
  3. Wählen Sie APIs und Dienste und suchen und aktivieren Sie die Maps SDK for Android

Driver SDK in Ihre App einbinden

Das Treiber-SDK ist im Google Maven-Repository verfügbar. Das Repository enthält die Project Object Model-Dateien (.pom) des SDK und Javadocs.

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.

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, den Sie bei der Einrichtung 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, um sicherer zu werden. auf den in Ihrer App verwiesen wird. Weitere Informationen zu Best Practices für die Sicherheit von API-Schlüsseln Weitere Informationen finden Sie im Google Maps Platform-Artikel zu Best Practices für die API-Sicherheit.

Sie können die GitHub-Dokumentation verwenden, um diese Aufgabe zu optimieren. Secrets Gradle-Plug-in für Android

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 folgenden Code in das dependencies-Element unter buildscript.

    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 folgenden Code in den plugins-Element.

    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. 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 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 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 nicht archivierten AAR-Datei.

Weitere Informationen finden Sie unter Open-Source-Hinweise einbinden. Open-Source-Hinweise enthalten.

Nächste Schritte

Abhängigkeiten deklarieren