Reisen mit Android verfolgen

Wenn Sie einer Fahrt folgen, wird dem Nutzer in Ihrer Consumer-App der Standort des entsprechenden Fahrzeugs angezeigt. Dazu muss Ihre App eine Fahrt starten, den Fortschritt der Fahrt aktualisieren und die Fahrt beenden, wenn sie abgeschlossen ist.

In diesem Dokument wird beschrieben, wie dieser Prozess funktioniert.

Hinweis

Achten Sie darauf, dass Sie Folgendes eingerichtet haben:

• Die Backend-Dienste für Ihre Verbraucher-App sind eingerichtet und Ihre Dienste für die Zuordnung von Verbrauchern zu Fahrzeugen sind betriebsbereit.

• Sie haben eine Karte für Ihre App eingerichtet.

Einer Reise folgen

Wenn Ihr Backend-Server einem Nutzer ein Fahrzeug zuweist, verwenden Sie JourneySharingSession, um die Fahrt zu verfolgen.

Der folgende Beispielcode zeigt, wie Sie nach dem Laden der Ansicht mit der Verfolgung einer Fahrt beginnen.

public class MainActivity extends AppCompatActivity
    implements ConsumerViewModel.JourneySharingListener  {

  // Class implementation

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Create a TripModel instance to listen for updates to the trip specified by this trip name.
    String tripName = ...;
    TripModelManager tripModelManager = consumerApi.getTripModelManager();
    TripModel tripModel = tripModelManager.getTripModel(tripName);

    // Create a JourneySharingSession instance based on the TripModel.
    JourneySharingSession session = JourneySharingSession.createInstance(tripModel);

    // Add the JourneySharingSession instance on the map for updating the UI.
    consumerController.showSession(session);

    // Register for trip update events.
    tripModel.registerTripCallback(new TripModelCallback() {
      @Override
      public void onTripETAToNextWaypointUpdated(
          TripInfo tripInfo, @Nullable Long timestampMillis) {
        // ...
      }

      @Override
      public void onTripActiveRouteRemainingDistanceUpdated(
          TripInfo tripInfo, @Nullable Integer distanceMeters) {
        // ...
      }

      // ...
    });
  }

  @Override
  protected void onDestroy() {
    super.onDestroy();

    if (journeySharingSession != null) {
      journeySharingSession.stop();
    }
  }
}

class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {

  // Class implementation

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Create a TripModel instance to listen for updates to the trip specified by this trip name.
    val tripName = "tripName"
    val tripModelManager = consumerApi.getTripModelManager()
    val tripModel = tripModelManager.getTripModel(tripName)

    // Create a JourneySharingSession instance based on the TripModel.
    val session = JourneySharingSession.createInstance(tripModel)

    // Add the JourneySharingSession instance on the map for updating the UI.
    consumerController.showSession(session)

    // Register for trip update events.
    tripModel.registerTripCallback(
      object : TripModelCallback() {
        override fun onTripETAToNextWaypointUpdated(
          tripInfo: TripInfo,
          timestampMillis: Long?,
        ) {
          // ...
        }

        override fun onTripActiveRouteRemainingDistanceUpdated(
          tripInfo: TripInfo,
          distanceMeters: Int?,
        ) {
          // ...
        }

      // ...
    })
  }

  override fun onDestroy() {
    super.onDestroy()

    journeySharingSession?.stop()
  }
}

Streckenfortschritt aktualisieren

Wenn Sie Details zum Fortschritt der Fahrt aktualisieren möchten, z. B. die Entfernung, die das Fahrzeug vor der Ankunft noch zurücklegen muss, und die voraussichtliche Ankunftszeit, muss Ihre App einen Listener registrieren und konfigurieren, wie in den folgenden Beispielen gezeigt.

1. Registrieren Sie einen Listener für ein TripModel-Objekt.

   Java

   // Create a TripModel instance for listening to updates to the trip specified by this trip name.
   String tripName = ...;
   TripModelManager tripModelManager = consumerApi.getTripModelManager();
   TripModel tripModel = tripModelManager.getTripModel(tripName);
   
   // Create a JourneySharingSession instance based on the TripModel.
   JourneySharingSession session = JourneySharingSession.createInstance(tripModel);
   
   // Add the JourneySharingSession instance on the map for updating the UI.
   consumerController.showSession(session);
   
   // Register for trip update events.
   tripModel.registerTripCallback(new TripModelCallback() {
   @Override
   public void onTripETAToNextWaypointUpdated(
           TripInfo tripInfo, @Nullable Long timestampMillis) {
         // ...
   }
   
   @Override
   public void onTripActiveRouteRemainingDistanceUpdated(
           TripInfo tripInfo, @Nullable Integer distanceMeters) {
         // ...
   }
   
   // ...
   });
   

   Kotlin

   // Create a TripModel instance for listening to updates to the trip specified by this trip name.
   val tripName = "tripName"
   val tripModelManager = consumerApi.getTripModelManager()
   val tripModel = tripModelManager.getTripModel(tripName)
   
   // Create a JourneySharingSession instance based on the TripModel.
   val session = JourneySharingSession.createInstance(tripModel)
   
   // Add the JourneySharingSession instance on the map for updating the UI.
   consumerController.showSession(session)
   
   // Register for trip update events.
   tripModel.registerTripCallback(
     object : TripModelCallback() {
       override fun onTripETAToNextWaypointUpdated(
         tripInfo: TripInfo,
         timestampMillis: Long?,
       ) {
         // ...
       }
   
       override fun onTripActiveRouteRemainingDistanceUpdated(
         tripInfo: TripInfo,
         distanceMeters: Int?,
       ) {
         // ...
       }
   
     // ...
   })
   

2. Konfigurieren Sie den Listener für Ihre Fahrt mit TripModelOptions.

   Java

   // Set refresh interval to 2 seconds.
   TripModelOptions tripOptions =
         TripModelOptions.builder().setRefreshIntervalMillis(2000).build();
   tripModel.setTripModelOptions(tripOptions);
   

   Kotlin

   // Set refresh interval to 2 seconds.
   val tripOptions = TripModelOptions.builder().setRefreshIntervalMillis(2000).build()
   tripModel.setTripModelOptions(tripOptions)
   

Einer Reise nicht mehr folgen

Achten Sie darauf, dass Ihre App die Fahrt beendet, wenn sie nicht mehr benötigt wird, z. B. wenn die Fahrt vom Fahrer im Backend als ABGESCHLOSSEN markiert wird. Durch das Beenden der Routenfreigabe werden unnötige Netzwerkanfragen an Fleet Engine vermieden und Speicherlecks verhindert.

Verwenden Sie JourneySharingSession, um die Routenführung zu beenden, wie im folgenden Beispielcode gezeigt.

public class MainActivity extends AppCompatActivity
    implements ConsumerViewModel.JourneySharingListener  {

  // Class implementation

  @Override
  protected void onDestroy() {
    super.onDestroy();

    if (journeySharingSession != null) {
      journeySharingSession.stop();
    }
  }
}

class SampleAppActivity : AppCompatActivity(), ConsumerViewModel.JourneySharingListener {

  // Class implementation

  override fun onDestroy() {
    super.onDestroy()

    journeySharingSession?.stop()
  }
}

Fehler bei Fahrten beheben

Die Methode onTripRefreshError gibt Fehler zurück, die während der Fahrtüberwachung auftreten. Fehlermeldungen entsprechen dem Google Cloud-Fehlerstandard. Detaillierte Definitionen von Fehlermeldungen und alle Fehlercodes finden Sie in der Google Cloud-Dokumentation zu Fehlern.

Im Folgenden finden Sie einige häufige Fehler, die während der Fahrtenaufzeichnung auftreten können:

Consumer SDK-Fehler beheben

Das Consumer SDK sendet Fehler bei der Aktualisierung von Fahrten über einen Callback-Mechanismus an die Consumer-App. Der Callback-Parameter ist ein plattformspezifischer Rückgabetyp (TripUpdateError unter Android und NSError unter iOS).

Statuscodes extrahieren

Die an den Callback übergebenen Fehler sind in der Regel gRPC-Fehler. Sie können auch zusätzliche Informationen in Form eines Statuscodes daraus extrahieren. Eine vollständige Liste der Statuscodes finden Sie unter Statuscodes und ihre Verwendung in gRPC.

// Called when there is a trip update error.
@Override
public void onTripUpdateError(TripInfo tripInfo, TripUpdateError error) {
  Status.Code code = error.getStatusCode();
}

// Called when there is a trip update error.
override fun onTripUpdateError(tripInfo: TripInfo, error: TripUpdateError) {
  val code = error.getStatusCode()
}

Statuscodes interpretieren

Statuscodes decken zwei Arten von Fehlern ab: Server- und Netzwerkfehler sowie clientseitige Fehler.

Server- und Netzwerkfehler

Die folgenden Statuscodes weisen auf Netzwerk- oder Serverfehler hin. Sie müssen nichts unternehmen, um diese Fehler zu beheben. Das Consumer SDK kann solche Fehler automatisch beheben.

Clientfehler

Die folgenden Statuscodes beziehen sich auf Clientfehler. Sie müssen Maßnahmen ergreifen, um diese zu beheben. Das Consumer SDK versucht weiterhin, die Fahrt zu aktualisieren, bis Sie die Fahrtfreigabe beenden. Es kann jedoch erst wieder funktionieren, wenn Sie Maßnahmen ergreifen.