Für das Treiber-SDK für Android 3.0 müssen Sie Ihren Code aktualisieren für bestimmte Operationen. In diesem Leitfaden werden die Änderungen und die die Sie ausführen müssen, um Ihren Code zu migrieren.
Änderung des Paketnamens
Der Paketname wurde geändert von
com.google.android.libraries.ridesharing.driver
bis
com.google.android.libraries.mapsplatform.transportation.driver
. Bitte
Aktualisieren Sie Verweise in Ihrem Code.
SDK initialisieren
In früheren Versionen initialisieren Sie das Navigation SDK und erhalten dann
einen Verweis auf die FleetEngine
-Klasse Im Treiber-SDK
Version 3 können Sie das SDK wie folgt initialisieren:
Rufen Sie ein
Navigator
-Objekt ausNavigationApi
ab.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; } } );
Erstellen Sie ein
DriverContext
-Objekt und füllen Sie die Pflichtfelder aus.DriverContext driverContext = DriverContext.builder(application) .setProviderId(providerId) .setVehicleId(vehicleId) .setAuthTokenFactory(authTokenFactory) .setNavigator(navigator) .setRoadSnappedLocationProvider( NavigationApi.getRoadSnappedLocationProvider(application)) .build()
Verwenden Sie das
DriverContext
-Objekt, um*DriverApi
zu initialisieren.RidesharingDriverApi ridesharingDriverApi = RidesharingDriverApi.createInstance(driverContext);
Rufen Sie die
NavigationVehicleReporter
aus dem API-Objekt ab.*VehicleReporter
verlängertNavigationVehicleReporter
.RidesharingVehicleReporter vehicleReporter = ridesharingDriverApi.getRidesharingVehicleReporter();
Standortaktualisierungen aktivieren und deaktivieren
In früheren Versionen sollten Sie Standortupdates aktivieren, nachdem Sie
Eine FleetEngine
-Referenz. Aktivieren Sie im Treiber SDK v3
Standortaktualisierungen wie folgt:
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Verwenden Sie zum Aktualisieren des Berichtsintervalls
RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit)
oder
DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit)
.
Standortaktualisierungen deaktivieren, wenn die Schicht des Fahrers beendet ist
und das Fahrzeug durch Aufrufen von NavigationVehicleReporter.disableLocationTracking()
als offline markieren.
Fahrzeugstatus auf dem Server festlegen
In früheren Versionen würden Sie das FleetEngine
-Objekt verwenden, um
Zustand des Fahrzeugs. Verwenden Sie in Treiber-SDK v3 die Methode
RidesharingVehicleReporter
-Objekt zum Festlegen des Fahrzeugstatus:
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);
Um den Fahrzeugstatus auf OFFLINE
festzulegen, rufen Sie
RidesharingVehicleReporter.disableLocationTracking()
. Fehler
Updates des Fahrzeugstatus mithilfe der optional bereitgestellten
StatusListener
wurde in DriverContext
festgelegt.
Error Reporting mit StatusListener
ErrorListener
wurde entfernt und mit StatusListener
kombiniert.
die so definiert werden kann:
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.
}
}
Mit AuthTokenFactory
authentifizieren
AuthTokenFactory
hat jetzt nur noch eine Methode, getToken()
, die
AuthTokenContext
als Parameter verwenden. Mitfahrdienste müssen
Authentifizierung für den Diensttyp VEHICLE
, wodurch die Standortermittlung aktiviert wird
Berichte zum Fahrzeugstatus (online/offline)
class JsonAuthTokenFactory implements AuthTokenFactory {
String vehicleServiceToken; // initially null
long expiryTimeMs = 0;
// This method is called on a thread whose only responsibility is to send
// location updates. Blocking is OK, but just know that no location updates
// can occur until this method returns.
@Override public String getToken(AuthTokenContext authTokenContext) {
if (System.currentTimeMillis() > expiryTimeMs) {
// The token has expired, go get a new one.
fetchNewToken(vehicleId);
}
if (ServiceType.VEHICLE.equals(authTokenContext.getServiceType)) {
return vehicleServiceToken;
} else {
throw new RuntimeException("Unsupported ServiceType: " + authTokenContext.getServiceType());
}
}
private void fetchNewToken(String vehicleId) {
String url = "https://yourauthserver.example/token/" + vehicleId;
try (Reader r = new URL(url).openStream()) {
com.google.gson.JsonObject obj
= new com.google.gson.JsonParser().parse(r);
vehicleServiceToken = obj.get("VehicleServiceToken").getAsString();
expiryTimeMs = obj.getAsLong("TokenExpiryMs");
// The expiry time could be an hour from now, but just to try and avoid
// passing expired tokens, we subtract 10 minutes from that time.
expiryTimeMs -= 10 * 60 * 1000;
} catch (IOException e) {
// It's OK to throw exceptions here, the StatusListener you passed to
// create the FleetEngine class will be notified and pass along the failed
// update warning.
throw new RuntimeException("Could not get auth token", e);
}
}
}