Per impostare e configurare un progetto nella console Google Cloud per l'utilizzo dell'SDK driver per Per Android, segui questa procedura.
- Configura il progetto di app mobile.
- Aggiungi l'SDK Driver all'app.
- Aggiungi la chiave API all'app.
- Includi le attribuzioni richieste nella tua app.
Per ulteriori 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 il driver l'SDK.
Per configurare il progetto dell'app mobile, segui questi passaggi:
- 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, vedi Crea il tuo progetto Fleet Engine.
- Nella console Google Cloud, seleziona lo stesso progetto nella console Google Cloud e Chiave API che stai utilizzando per Fleet Engine.
- Seleziona API e Services, quindi cerca e attiva Maps SDK per Android.
Aggiungi l'SDK Driver alla tua 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 l'SDK Driver e l'SDK di navigazione delle dipendenze 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 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 maggiori dettagli, consulta l'articolo Configurare il progetto dell'app mobile.
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 plug-in Secrets Gradle per Android.
Per installare il plug-in e memorizzare la chiave API, procedi nel seguente modo:
Apri il file
build.gradle
a livello di directory principale e aggiungi il seguente codice alla Elementodependencies
inbuildscript
.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") } }
Apri il file
build.gradle
a livello di app e aggiungi il seguente codice alla Elementoplugins
.Trendy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
Se utilizzi Android Studio, sincronizza il tuo progetto con Gradle. Per maggiori dettagli, vedi Sincronizza il progetto con Gradle.
Apri
local.properties
nella directory a livello di progetto, quindi aggiungi il seguente codice. SostituisciYOUR_API_KEY
con la tua chiave API.MAPS_API_KEY=YOUR_API_KEY
Nel file
AndroidManifest.xml
, vai acom.google.android.geo.API_KEY
e aggiorna l'attributoandroid: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 nella tua app utilizzi l'SDK Driver, devi includere il testo di 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 l'articolo Includi notifiche open source su come includere avvisi open source.