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
- Autenticazione: chiave API, JSON Web Token (JWT)
- Attiva anche: Maps SDK for Android
- Inizia: configura l'SDK Driver per Android
- Riferimento: Riferimento SDK Driver per Android
- Norme: norme relative all'SDK Driver for Android
- Note di rilascio: note di rilascio dell'SDK Driver per Android
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: prodotti correlati
- Spesso utilizzato con: Navigation SDK for Android, servizio Fleet Engine
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
AuthTokenFactoryal 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.grpceokio. 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#fromLatLngeNavigator#startGuidance(resumeIntent)rimossi nella versione 3.0. Consulta la guida alla migrazione. AuthTokenContextServiceType: ritirato dal 29/11/2021. Sostituzione: rivendicazioni per l'ID veicolo e l'ID attività inclusi. Sintomo: rimosso nella versione 4.0.0:ServiceTypeegetServiceType()daAuthTokenContextesetServiceTypedaAuthTokenContext.Builder. Consulta la guida alla migrazione.- Proprietà
TaskparentId: 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.
- Segnala la posizione in tempo reale di un veicolo al servizio Fleet Engine.
- Segnala le coordinate di latitudine/longitudine dei waypoint del percorso di un veicolo dall'SDK di navigazione al servizio Fleet Engine.
- Segnala al servizio Fleet Engine la distanza rimanente di un veicolo dal waypoint successivo.
- Segnala al servizio Fleet Engine l'orario di arrivo stimato di un veicolo al waypoint successivo.
- Segnala al servizio Fleet Engine il percorso fornito per un veicolo dall'SDK Navigation.