La release dell'SDK driver per Android 3.0 richiede l'aggiornamento del codice per alcune operazioni. Questa guida illustra le modifiche e gli aspetti che dovrai fare per eseguire la migrazione del codice.
Modifica del nome del pacchetto
Il nome del pacchetto è cambiato da
Da com.google.android.libraries.ridesharing.driver
a
com.google.android.libraries.mapsplatform.transportation.driver
. Non dimenticare di apporre
aggiorna i riferimenti nel codice.
Inizializzazione dell'SDK
Nelle versioni precedenti, dovevi inizializzare l'SDK di navigazione e quindi ottenere
un riferimento alla classe FleetEngine
. Nell'SDK Driver
v3, inizializza l'SDK come segue:
Ottieni un oggetto
Navigator
daNavigationApi
.NavigationApi.getNavigator( this, // Activity new NavigationApi.NavigatorListener() { @Override public void onNavigatorReady(Navigator navigator) { // Keep a reference to the Navigator (used to configure and start nav) this.navigator = navigator; } } );
Crea un oggetto
DriverContext
e compila i campi obbligatori.DriverContext driverContext = DriverContext.builder(application) .setProviderId(providerId) .setVehicleId(vehicleId) .setAuthTokenFactory(authTokenFactory) .setNavigator(navigator) .setRoadSnappedLocationProvider( NavigationApi.getRoadSnappedLocationProvider(application)) .build()
Utilizza l'oggetto
DriverContext
per inizializzare*DriverApi
.Ottieni
NavigationVehicleReporter
dall'oggetto API.*VehicleReporter
estendeNavigationVehicleReporter
.
Attivazione e disattivazione degli aggiornamenti della posizione
Nelle versioni precedenti, dovevi attivare gli aggiornamenti della posizione dopo aver ottenuto
un riferimento FleetEngine
. In Driver SDK v3, abilita
aggiornamenti della posizione come segue:
Per aggiornare l'intervallo dei report, utilizza
RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit)
o
DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit)
.
Al termine del turno del conducente, disattiva gli aggiornamenti della posizione
e contrassegna il veicolo come offline chiamando il numero NavigationVehicleReporter.disableLocationTracking()
.
Error Reporting con StatusListener
ErrorListener
è stato rimosso e combinato con StatusListener
,
che possono essere definite come segue:
class MyStatusListener implements StatusListener {
/** Called when background status is updated, during actions such as location reporting. */
@Override
public void updateStatus(
StatusLevel statusLevel,
StatusCode statusCode,
String statusMsg) {
// Status handling stuff goes here.
// StatusLevel may be DEBUG, INFO, WARNING, or ERROR.
// StatusCode may be DEFAULT, UNKNOWN_ERROR, VEHICLE_NOT_FOUND,
// BACKEND_CONNECTIVITY_ERROR, or PERMISSION_DENIED.
}
}