Migrationsanleitung für Android Driver SDK 3.0

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:

  1. Rufen Sie ein Navigator-Objekt aus 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 Pflichtfelder 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 *DriverApi zu initialisieren.

  4. Rufen Sie die NavigationVehicleReporter aus dem API-Objekt ab. *VehicleReporter verlängert NavigationVehicleReporter.

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:

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.

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