Configurare un progetto nella console Google Cloud

Per impostare e configurare una console Google Cloud per l'utilizzo dell'SDK consumer per Per Android, segui questa procedura.

  1. Configura il progetto di sviluppo.
  2. Aggiungi l'SDK consumer 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.

Configura il progetto di sviluppo

Se non hai un progetto di sviluppo nella console Google Cloud e una chiave API per il tuo progetto di mobilità, devi impostarne uno. Per maggiori dettagli, vedi Crea il tuo progetto nella guida di Fleet Engine.

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

Aggiungi l'SDK consumer alla tua app

L'SDK consumer è disponibile in un repository Maven privato. Il repository include i file Project Object Model (.pom) e Javadocs dell'SDK. Per aggiungere il parametro SDK consumer nella tua app:

  1. Configura l'ambiente per accedere al Repository Maven host come descritto in Passaggio 2 di questa guida.

  2. Aggiungi le dipendenze dell'SDK consumer e dell'SDK Maps a Gradle o Maven configurazione.

    Negli esempi seguenti, sostituisci VERSION_NUMBER con il valore obbligatorio dell'SDK consumer:

    Gradle

    Aggiungi il seguente codice a build.gradle:

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

    Maven

    Aggiungi il seguente codice 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>

Aggiungi la chiave API all'app

Dopo aver aggiunto l'SDK consumer all'app, aggiungi la chiave API. Devi utilizzare la chiave API del progetto che hai ottenuto durante la configurazione del progetto di sviluppo. Per Per ulteriori dettagli, consulta Configurare il progetto di sviluppo nel Passaggio 3 di questa guida.

Questa sezione descrive come archiviare la chiave API in modo che possa essere a cui fa riferimento la 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 Secrets Gradle Plug-in 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 tuo progetto con Gradle. Per maggiori dettagli, vedi Sincronizza il tuo progetto con Gradle nella documentazione di Android.

  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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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 nella tua app usi l'SDK consumer, devi includere il testo dell'attribuzione e licenze open source nell'ambito della sezione delle note legali della tua app. È meglio Includere le attribuzioni come voce di menu indipendente o come parte di una sezione Informazioni voce di menu.

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

Consulta la pagina https://developers.google.com/android/guides/opensource per scoprire come includono avvisi open source.

Passaggi successivi

Recuperare i token di autenticazione