Riferimento rapido per l'SDK Driver per Android

L'SDK Driver per Android è un toolkit mobile per le app per i conducenti che invia gli aggiornamenti sulla posizione del veicolo, sul percorso, sulla distanza rimanente e sull'orario di arrivo stimato dall'SDK Navigation a Fleet Engine. Supporta sia le corse on demand sia le attività pianificate.

SDK Driver per Android: informazioni principali

  • Prodotto: SDK Driver per Android
  • Noto anche come: SDK Driver, SDK Driver per corse on demand, SDK Driver per attività pianificate
  • Categoria: Percorsi
  • Piattaforma: Android
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'SDK Driver per Android

SDK Driver per Android: quando utilizzarlo

Utilizzare Driver SDK per Android quando:

  • L'app per conducenti Android deve inviare aggiornamenti in tempo reale sulla posizione e sul percorso del veicolo a Fleet Engine.
  • Per ricevere la distanza rimanente e l'orario di arrivo stimato al waypoint successivo dal Navigation SDK, è necessario Fleet Engine.
  • Hai bisogno di un'app per i conducenti che gestisca le corse on demand o le attività pianificate assegnate e fornisca la navigazione.

Non utilizzare Driver SDK per Android quando:

  • Hai bisogno solo della navigazione passo passo nella tua app e non utilizzi Fleet Engine. Utilizza invece l'SDK Navigation per Android.
  • Devi inviare aggiornamenti dei dati del veicolo diversi da posizione, percorso, distanza e ora di arrivo stimata (questi passano attraverso il tuo backend). Utilizza invece il servizio Fleet Engine.
  • Crei l'app per i conducenti per iOS. Utilizza invece l'SDK Driver per iOS.

Driver SDK per Android: configurazione

Pacchetti SDK Driver per Android ufficiali:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

SDK Driver per Android: errori comuni

  • Problema: se le dipendenze di build non specificano una versione dell'SDK Driver, l'IDE carica la versione più recente; a partire dalla versione 7.0.0, le nuove build non supportano più Android 6 e 7 (API 23-25). Correzione: specifica una versione esplicita di Driver SDK for Android nelle dipendenze di build per controllare quando cambia il sistema operativo minimo supportato. Consulta /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
  • Problema: l'SDK Driver dipende dall'SDK Navigation. Senza una versione dell'SDK Navigation bloccata, il progetto scarica sempre l'SDK Navigation più recente all'interno della versione principale. Correzione: aggiungi le dipendenze sia dell'SDK Driver sia dell'SDK Navigation. Se blocchi l'SDK Navigation, scegli una versione nell'intervallo elencato nelle note di rilascio per la tua versione dell'SDK Driver (ad esempio, [7.0, 8.0) per l'SDK Driver 7.1). Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
  • Problema: l'SDK richiede i token di autorizzazione tramite AuthTokenFactory al momento dell'aggiornamento della posizione; se il tuo server non può emettere JWT, gli aggiornamenti a Fleet Engine non possono essere autorizzati. Correzione: assicurati che l'implementazione lato server possa emettere token prima di inizializzare l'SDK e riutilizza i token fino alla loro scadenza. Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate.
  • Problema: le build di ProGuard possono generare avvisi per le classi com.google, io.grpc e okio. Correzione: aggiungi -dontwarn com.google.**, -dontwarn io.grpc.** e -dontwarn okio.** alla configurazione di ProGuard. Consulta /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.

Driver SDK for Android: funzionalità legacy e deprecate

  • Interfaccia StatusListener: ritirata dal 25/11/2024. Sostituzione: DriverStatusListener. Sintomo: rimosso nell'SDK Driver per Android v6.0.0. Consulta la guida alla migrazione.
  • SDK Nav/Driver per Android v1.x (binario combinato): ritirato dal 21 giugno 2022. Sostituzione: file binari separati per Driver SDK v3 e versioni successive e Navigation SDK. Sintomo: ritirato il 21 giugno 2021 e non più gestito dopo il 21 giugno 2022; metodi come Waypoint#fromLatLng e Navigator#startGuidance(resumeIntent) rimossi nella versione 3.0. Consulta la guida alla migrazione.
  • AuthTokenContext ServiceType: ritirato dal 29/11/2021. Sostituzione: rivendicazioni per l'ID veicolo e l'ID attività inclusi. Sintomo: rimosso nella versione 4.0.0: ServiceType e getServiceType() da AuthTokenContext e setServiceType da AuthTokenContext.Builder. Consulta la guida alla migrazione.
  • Proprietà Task parentId: ritirata dal 28 aprile 2022. Sostituzione: trackingId. Sintomo: rinominata nella versione 4.1.0; la proprietà precedente esiste ancora, ma è deprecata.

Cosa puoi fare con l'SDK Driver per Android

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.