Riferimento rapido per l'SDK Consumer per Android

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

Pacchetti SDK Consumer per Android ufficiali:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

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-maps definita esplicitamente insieme a transportation-consumer in 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 in onDestroy() 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 prima ConsumerApi.getInstance() e controlla il valore Task restituito 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=false quando 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 Trip e annotazioni Trip.TripStatus / Trip.TripType (e TripInfo#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.
  • MarkerStyleOptions e PolylineStyleOptions: ritirati dal 30/11/2021. Sostituzione: MarkerOptions e PolylineOptions (condivisi con Maps SDK). Sintomo: l'SDK Consumer applica il proprio stile predefinito per tipo di indicatore o polilinea, non i valori predefiniti di MarkerOptions. 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.