L'SDK Consumer per Android fa parte di Fleet Engine per i percorsi on demand. Fornisce interfacce che modellano i dati dei percorsi e seguono i percorsi in Fleet Engine, nonché classi per creare una visualizzazione basata su mappa che condivide l'avanzamento di un percorso (posizione del veicolo, itinerario, ora di arrivo stimata, distanza rimanente, traffico) con i consumatori in un'app per Android.
SDK consumer per Android: informazioni chiave
- Prodotto: SDK Consumer per Android
- Noto anche come: SDK Consumer per Android, SDK Consumer, SDK Consumer per Android per corse on demand di Mobility Services
- Categoria: Percorsi
- Piattaforma: Android
- Esecuzione su: client (codice dell'app o del browser)
- Fase di lancio: GA
- Ciclo di vita: Attivo
- Panoramica: Panoramica di Consumer SDK for Android
SDK Consumer per Android: quando utilizzarlo
Utilizza l'SDK Consumer per Android quando:
- Devi consentire ai consumatori della tua app per Android di seguire un percorso on demand (corsa, ordine o consegna) monitorato dal tuo backend in Fleet Engine.
- Devi mostrare la posizione e il percorso di un veicolo quasi in tempo reale, agganciati alla strada, su una mappa in un'app per utenti finali Android.
- Devi mostrare l'orario di arrivo previsto per il ritiro e la consegna, la distanza rimanente e il traffico in tempo reale per un percorso di Fleet Engine in Android.
- Devi personalizzare gli indicatori di percorso, le polilinee del percorso o lo stile di mappa per una mappa di condivisione del percorso in Android.
Non utilizzare l'SDK Consumer per Android quando:
- Hai bisogno della condivisione del percorso per le corse on demand in un'app per iOS. Utilizza invece l'SDK Consumer per iOS.
- Hai bisogno della condivisione del percorso in una pagina web o del monitoraggio da parte dei consumatori di attività pianificate come le spedizioni. Utilizza invece l'SDK consumer JavaScript.
- Devi segnalare la posizione del conducente e l'avanzamento del percorso dall'app per Android del conducente. Utilizza invece l'SDK Driver per Android.
SDK Consumer per Android: configurazione
- Autenticazione: token web JSON (JWT), chiave API
- Attiva anche: servizio Fleet Engine, Maps SDK for Android
- Inizia: configura l'SDK Consumer per Android
- Riferimento: Riferimento SDK Consumer per Android
- Policy: policy di Consumer SDK for Android
- Note di rilascio: note di rilascio di Consumer SDK for Android
Pacchetti SDK Consumer per Android ufficiali:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
SDK Consumer per Android: prodotti correlati
- Spesso utilizzato con: servizio Fleet Engine, SDK Driver for Android, Maps SDK for Android
SDK Consumer per Android: errori comuni
- Problema: se la dipendenza dall'SDK Maps non è impostata su una versione esplicita, l'SDK Consumer utilizza la versione minima richiesta dell'SDK Maps, il che può causare l'interruzione delle app che si basano su funzionalità delle versioni successive dell'SDK Maps. Correzione: dichiara una versione
play-services-mapsdefinita esplicitamente insieme atransportation-consumerin Gradle o Maven. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project. - Problema: se non interrompi la condivisione del percorso dopo la fine di una corsa, si verificano richieste di rete non necessarie a Fleet Engine e perdite di memoria. Correzione: chiama
JourneySharingSession.stop()quando la corsa non è più necessaria, ad esempio inonDestroy()o quando la corsa èCOMPLETE. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey. - Problema:
ConsumerApi.initialize()genera un'eccezione se esiste già un'istanza API (2.0.0 e versioni successive). Correzione: chiama primaConsumerApi.getInstance()e controlla il valoreTaskrestituito per determinare se esiste già un'istanza. Consulta /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android. - Problema: l'SDK Consumer v3 e versioni precedenti non supporta la modalità R8 completa; le app che hanno come target AGP 8.0 e versioni successive possono riscontrare problemi di build o di runtime. Correzione: imposta
android.enableR8.fullMode=falsequando scegli come target AGP 8.0 o versioni successive e utilizza AGP 7.3 o versioni successive con Kotlin 2.0 per l'SDK Consumer 3.0 o versioni successive. Consulta /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.
SDK Consumer per Android: funzionalità legacy e deprecate
ConsumerTrip,ConsumerTripCallback,ConsumerTripManager,ConsumerTripOptions: ritirato dal 15/09/2023. Sostituzione:TripModel,TripModelCallback,TripModelManager,TripModelOptions. Consulta la guida alla migrazione.- Classe
Tripe annotazioniTrip.TripStatus/Trip.TripType(eTripInfo#getTripStatus(),TripInfo#getTripType(),TripModelCallback#onTripStatusUpdated): ritirate dal 15 settembre 2023. Sostituzione:TripInfo.TripStatus/TripInfo.TripType,TripInfo#getCurrentTripStatus(),TripInfo#getCurrentTripType(),TripModelCallback#onTripStatusUpdate. Consulta la guida alla migrazione. MarkerStyleOptionsePolylineStyleOptions: ritirati dal 30/11/2021. Sostituzione:MarkerOptionsePolylineOptions(condivisi con Maps SDK). Sintomo: l'SDK Consumer applica il proprio stile predefinito per tipo di indicatore o polilinea, non i valori predefiniti diMarkerOptions. Consulta la guida alla migrazione.- Canale di distribuzione del repository privato: deprecato. Sostituzione: repository Maven di Google (versioni 2.1.0 e successive). Consulta la guida alla migrazione.
Cosa puoi fare con l'SDK Consumer per Android
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Aggiungi una mappa interattiva e personalizzabile che monitora l'avanzamento di un percorso da Fleet Engine a un'app mobile.
- Aggiungi una polilinea del percorso che monitora un percorso da Fleet Engine a una mappa su una pagina web o un'app mobile.
- Aggiorna l'avanzamento della corsa lungo un percorso in una mappa su una pagina web o un'app mobile per una corsa di Fleet Engine.
- Modifica lo stile di strade, polilinee e poligoni su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Mostra o nascondi gli elementi della mappa su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica lo stile delle icone e delle etichette di testo su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Applica stili di mappa diversi a livelli di zoom diversi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Modifica la densità dei luoghi su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre il controllo della densità dei PDI è una funzionalità sperimentale della personalizzazione delle mappe basata su cloud (supportata solo negli stili di mappa chiari).
- Modifica lo stile degli edifici su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione dello stile degli edifici in 3D e con impronta è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Modifica lo stile dei punti di riferimento su una mappa che monitora l'avanzamento di un percorso da Fleet Engine. Sperimentale Nota: il supporto della personalizzazione delle mappe basata su cloud nell'SDK Consumer è in disponibilità generale, mentre la personalizzazione delle icone dei punti di riferimento è una funzionalità di personalizzazione delle mappe basata su cloud sperimentale (supportata solo negli stili di mappa chiari).
- Personalizza un indicatore su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.
- Personalizza la polilinea del percorso su una mappa che monitora l'avanzamento di un percorso da Fleet Engine.