Configurare un progetto nella console Google Cloud

Per impostare e configurare un progetto nella console Google Cloud per l'utilizzo dell'SDK driver per Per Android, segui questa procedura.

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

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

Configurare il progetto dell'app mobile

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

Per configurare il progetto dell'app mobile, segui questi passaggi:

  1. Se non hai un progetto di sviluppo nella console Google Cloud e una chiave API per il tuo progetto di mobilità, devi configurarne uno. Per ulteriori informazioni, consulta la sezione 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 Services, quindi cerca e attiva Maps SDK per Android.

Aggiungere l'SDK Driver all'app

L'SDK Driver è disponibile nel repository Maven di Google. Il repository include i file Project Object Model (.pom) e Javadocs dell'SDK.

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

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

Gradle

Aggiungi il seguente codice 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 il seguente codice 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 l'SDK Driver alla tua app, aggiungi la chiave API. Devi utilizzare la chiave API del progetto ottenuta durante la configurazione del progetto di sviluppo. Per maggiori dettagli, vedi Configurare il progetto di app mobile.

Questa sezione descrive come memorizzare la chiave API in modo che possa essere richiamata in modo più sicuro dalla tua app. Per saperne di più 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 operazione, puoi utilizzare la documentazione di GitHub relativa al plug-in Secrets Gradle per Android.

Per installare il plug-in e memorizzare la chiave API:

  1. Apri il file build.gradle a livello di directory principale e aggiungi il seguente codice alla Elemento dependencies in buildscript.

    Trendy

    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 alla Elemento plugins.

    Trendy

    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, vedi Sincronizza il progetto con Gradle.

  4. Apri local.properties nella directory a livello di progetto, quindi 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 l'SDK Driver nella tua app, devi includere il testo di attribuzione e le licenze open source nella sezione delle notifiche legali dell'app. È preferibile includere le attribuzioni come voce di menu indipendente o all'interno di una voce di menu Informazioni.

Puoi trovare le informazioni sulla licenza nel file "third_party_licenses.txt" nel file AAR non sottoposto ad archiviazione.

Per informazioni su come includere le notifiche relative all'open source, consulta Includere le notifiche relative all'open source.

Passaggi successivi

Dichiarare le dipendenze