Configurare un progetto nella console Google Cloud

Per configurare una console Google Cloud in modo da utilizzare Consumer SDK per Android, segui questi passaggi.

  1. Configura il progetto di sviluppo.
  2. Aggiungi l'SDK Consumer alla tua app.
  3. Aggiungi la chiave API alla tua app.
  4. Includi le attribuzioni richieste nella tua app.

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

Configurare il progetto di sviluppo

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 dettagli, consulta la sezione Creare il progetto nella guida di Fleet Engine.

Quando selezioni il progetto di sviluppo per l'SDK Consumer, seleziona lo stesso progetto della console Google Cloud e la stessa chiave API che utilizzi per Fleet Engine.

Aggiungere l'SDK Consumer alla tua app

L'SDK Consumer è disponibile nel repository Maven di Google. Il repository include i file Project Object Model (.pom) e Javadoc dell'SDK. Per aggiungere l'SDK Consumer alla tua app, aggiungi le dipendenze dell'SDK Consumer e dell'SDK Maps alla tua configurazione Gradle o Maven.

Nei seguenti esempi, sostituisci VERSION_NUMBER con la versione richiesta dell'SDK Consumer:

Gradle

Aggiungi quanto segue a build.gradle:

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

Maven

Aggiungi quanto segue a pom.xml:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

Aggiungere la chiave API all'app

Dopo aver aggiunto l'SDK Consumer 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, vedi Configurare il progetto di sviluppo nel passaggio 3 di questa guida.

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 di Google Maps Platform 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:

  1. Apri il file build.gradle a livello di radice e aggiungi il seguente codice all'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 all'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, consulta Sincronizzare il progetto con Gradle nella documentazione di Android.

  4. Apri il file 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="${M>APS_API_KEY}" /

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

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.c>onsumerap<idemo"
        uses-permission android:name="android.permissio>n.ACCESS_<FINE_LOCATION" /
        application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:sup>portsRtl="<;true"
            android:theme="@style/_AppTheme"

            meta-data
                android:name=&q>uot;com.google<.android.geo.API_KEY"
          >      android:val<ue="${MA>PS_API_KEY}" /

<            activity android:name=".MainActiv>ity"
           <     intent-filter
                    action android:name>="android.in<tent.action.MA>IN" /
  <         >         <category and>roid:<name=&quo>t;android.intent.category.LAUNCHER" /
                /intent-filter
            /activity
        /application
    /manifest

Includere le attribuzioni richieste nella tua app

Se utilizzi l'SDK Consumer nella tua app, devi includere il testo di attribuzione e le licenze open source nella sezione delle note legali dell'app. È consigliabile 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 decompresso.

Consulta la pagina https://developers.google.com/android/guides/opensource per scoprire come includere le note relative all'open source.

Passaggi successivi

Ottenere token di autenticazione