Migrationsanleitung für Android Driver SDK 3.0

Für die Version 3.0 des Driver SDK for Android müssen Sie Ihren Code für bestimmte Vorgänge aktualisieren. In diesem Leitfaden werden die Änderungen beschrieben und erläutert, was Sie zur Migration Ihres Codes tun müssen.

Änderung des Paketnamens

Der Paketname wurde von com.google.android.libraries.ridesharing.driver in com.google.android.libraries.mapsplatform.transportation.driver geändert. Bitte aktualisieren Sie die Verweise in Ihrem Code.

SDK initialisieren

In früheren Versionen haben Sie das Navigation SDK initialisiert und dann eine Referenz auf die Klasse FleetEngine abgerufen. So initialisieren Sie das SDK im Driver SDK v3:

  1. Rufe ein Navigator-Objekt vom NavigationApi 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;
        }
      }
);

  2. Erstellen Sie ein DriverContext-Objekt und füllen Sie die erforderlichen Felder aus.

    DriverContext driverContext = DriverContext.builder(application)
             .setProviderId(providerId)
             .setVehicleId(vehicleId)
             .setAuthTokenFactory(authTokenFactory)
             .setNavigator(navigator)
             .setRoadSnappedLocationProvider(
                 NavigationApi.getRoadSnappedLocationProvider(application))
             .build()

  3. Verwenden Sie das DriverContext-Objekt, um die *DriverApi zu initialisieren.

  4. Rufe NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter erstreckt sich über NavigationVehicleReporter.

Standortaktualisierungen aktivieren und deaktivieren

In früheren Versionen haben Sie Standortupdates aktiviert, nachdem Sie eine FleetEngine-Referenz erhalten haben. So aktivieren Sie Standortupdates im Driver SDK v3:

Verwenden Sie RidesharingVehicleReporter.setLocationReportingInterval(long, TimeUnit) oder DeliveryVehicleReporter.setLocationReportingInterval(long, TimeUnit), um das Berichtszeitraum zu aktualisieren.

Wenn die Schicht des Fahrers beendet ist, deaktivieren Sie die Standortaktualisierungen und markieren Sie das Fahrzeug als offline, indem Sie NavigationVehicleReporter.disableLocationTracking() anrufen.

Fehlerberichte mit StatusListener

ErrorListener wurde entfernt und mit StatusListener kombiniert, das 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.
  }
}