Configurare un progetto nella console Google Cloud

Per configurare un progetto della console Google Cloud in modo da utilizzare Driver SDK per Android, segui questi passaggi.

  1. Configura il progetto dell'app mobile.
  2. Aggiungi Driver SDK alla tua app.
  3. Aggiungi la chiave API all'app.
  4. Includi le attribuzioni richieste nella tua app.

Per maggiori dettagli su ogni passaggio, consulta le sezioni seguenti.

Configura il progetto dell'app mobile

Questa sezione descrive come configurare il progetto dell'app mobile per Driver SDK.

Per configurare il progetto dell'app mobile:

  1. Se non hai un progetto di sviluppo della console Google Cloud e una chiave API per il tuo progetto di mobilità, devi configurarne uno. Per maggiori informazioni, consulta Creare il progetto Fleet Engine.
  2. Nella console Google Cloud, seleziona lo stesso progetto della console Google Cloud e la stessa chiave API che utilizzi per Fleet Engine.
  3. Seleziona API e servizi , cerca e attiva Maps SDK per Android.

Aggiungi Driver SDK alla tua app

Driver SDK è disponibile nel repository Maven di Google. Il repository include i file del modello di oggetto del progetto (.pom) e i Javadoc dell'SDK.

Per aggiungere Driver SDK alla tua app, aggiungi le dipendenze di Driver SDK e Navigation SDK alla configurazione di Gradle o Maven.

Nell'esempio seguente, sostituisci VERSION_NUMBER con la versione selezionata di Driver SDK.

Gradle

Aggiungi quanto segue a build.gradle:

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

Maven

Aggiungi quanto segue a pom.xml:

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

Aggiungi la chiave API all'app

Dopo aver aggiunto Driver SDK alla tua app, aggiungi la chiave API. Devi utilizzare la chiave API del progetto che hai ottenuto quando hai configurato il progetto di sviluppo. Per maggiori dettagli, consulta Configurare il progetto dell'app mobile.

Questa sezione descrive come archiviare la chiave API in modo che possa essere referenziata in modo più sicuro dalla tua app. Per ulteriori informazioni sulle best practice per la sicurezza delle chiavi API, consulta l'articolo della piattaforma Google Maps sulle best practice per la sicurezza delle API.

Per semplificare questa attività, puoi utilizzare la documentazione di GitHub Plug-in Secrets Gradle per Android.

Per installare il plug-in e archiviare la chiave API, segui questi passaggi:

  1. Apri il file build.gradle a livello di root e aggiungi il seguente codice all'elemento dependencies sotto 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. Apri il file build.gradle a livello di app e aggiungi il seguente codice all'elemento plugins.

    Groovy

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    Kotlin

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. Se utilizzi Android Studio, sincronizza il progetto con Gradle. Per maggiori dettagli, consulta Sincronizzare il progetto con Gradle.

  4. Apri local.properties nella directory a livello di progetto e aggiungi il seguente codice. Sostituisci YOUR_API_KEY con la tua chiave API.

    MAPS_API_KEY=YOUR_API_KEY

  5. Nel file AndroidManifest.xml, vai a com.google.android.geo.API_KEY e aggiorna l'attributo android:value come segue:

       <meta-data
           android:name="com.google.android.geo.API_KEY"
           android:value="${MAPS_API_KEY}" />

L'esempio seguente mostra un manifest completo per un'app di esempio:

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

Includi le attribuzioni richieste nella tua app

Se utilizzi Driver SDK nella tua app, devi includere il testo dell'attribuzione e le licenze open source nella sezione delle note legali dell'app. È preferibile includere le attribuzioni come voce di menu indipendente o come parte di una voce di menu Informazioni.

Puoi trovare le informazioni sulla licenza nel file "third_party_licenses.txt" nel file AAR non archiviato.

Consulta Includere le note relative all'open source per scoprire come includere le note relative all'open source.

Passaggi successivi

Dichiarazione di dipendenze