Migrationsanleitung für Android Driver SDK 3.0

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

Änderung des Paketnamens

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

SDK initialisieren

In früheren Versionen haben Sie das Navigation SDK initialisiert und dann einen Verweis auf die Klasse FleetEngine abgerufen. In Driver SDK v3 initialisieren Sie das SDK so:

  1. Rufen Sie ein Navigator-Objekt von der 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. Rufen Sie den NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter erweitert NavigationVehicleReporter.

Standortaktualisierungen aktivieren und deaktivieren

In früheren Versionen haben Sie Standortaktualisierungen aktiviert, nachdem Sie einen FleetEngine-Verweis abgerufen haben. In Driver SDK v3 aktivieren Sie Standortaktualisierungen so:

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

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

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.
  }
}