Google Cloud Console-Projekt konfigurieren

So richten Sie ein Google Cloud Console-Projekt ein und konfigurieren es, um das Driver SDK für Android-Gerät verwenden, führen Sie diese Schritte aus.

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

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

Projekt für mobile Apps einrichten

In diesem Abschnitt wird beschrieben, wie Sie Ihr mobiles App-Projekt für den Treiber konfigurieren. SDK.

So konfigurieren Sie Ihr Projekt für mobile Apps:

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

Treiber-SDK zur App hinzufügen

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

Fügen Sie das Driver SDK und das Navigation SDK hinzu, um Ihrer App das Treiber-SDK hinzuzufügen. mit Ihrer Gradle- oder Maven-Konfiguration verknüpfen.

Hinweis: Das Driver SDK hängt vom Navigation SDK ab. Legen Sie für Ihre Abhängigkeit eine explizit definierte Version des Navigation SDK, wie in diesem Beispiel gezeigt. Andernfalls lassen Sie den Beispielcodeblock weg, damit das Projekt immer heruntergeladen werden kann. die neueste Version des Navigation SDK innerhalb der Hauptversion. Die Die Kombination der aktuellen Versionen des Driver SDK und des Navigation SDK wurden vor ihrer Veröffentlichung strengen Tests unterzogen.

Ersetzen Sie VERSION_NUMBER im folgenden Beispiel durch die ausgewählte Version. des Treiber-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. Für 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.

Wichtig :Prüfen Sie Ihren API-Schlüssel nicht in Ihr Versionsverwaltungssystem. Stattdessen in der Datei local.properties speichern, die sich im Stammverzeichnis befindet Ihres Projekts. Weitere Informationen zur Datei local.properties finden Sie unter Gradle-Attributdateien.

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 Synchronisieren Sie Ihr Projekt mit Gradle.

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>

Hinweis : Für eine optimale Navigation sollte der Fahrer Folgendes mitteilen: Berechtigungen: android.permission.ACCESS_COARSE_LOCATION und android.permission.ACCESS_FINE_LOCATION Beides muss unter Laufzeit in der App.

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 finden Sie im Abschnitt mit den rechtlichen Hinweisen Ihrer App. Am besten Die Quellenangaben sollten als eigenständiges Menüelement oder in der Infoseite hinzugefügt werden. Menüpunkt.

Die Lizenzinformationen finden Sie in der Datei „third_party_Licenses.txt“. Datei in nicht mehr archivierte AAR-Dateien.

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

Nächste Schritte

Abhängigkeiten deklarieren