Diese Seite wurde von der Cloud Translation API übersetzt.

Reisen auf iOS-Geräten verfolgen

Plattform auswählen: Android iOS JavaScript

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.

Einer Reise folgen

So folgen Sie einer Reise:

Alle Nutzereingaben wie Abhol- und Abgabeorte aus einem ViewController erfassen.
Erstellen Sie eine neue ViewController, um einer Reise direkt zu folgen.

Im folgenden Beispiel wird gezeigt, wie Sie eine Fahrt direkt nach dem Laden der Ansicht verfolgen können.

Swift

/*
 * MapViewController.swift
 */
override func viewDidLoad() {
  super.viewDidLoad()
  ...
  self.mapView = GMTCMapView(frame: UIScreen.main.bounds)
  self.mapView.delegate = self
  self.view.addSubview(self.mapView)
}

func mapViewDidInitializeCustomerState(_: GMTCMapView) {
  self.mapView.pickupLocation = self.selectedPickupLocation
  self.mapView.dropoffLocation = self.selectedDropoffLocation

  self.startConsumerMatchWithLocations(
    pickupLocation: self.mapView.pickupLocation!,
    dropoffLocation: self.mapView.dropoffLocation!
  ) { [weak self] (tripName, error) in
    guard let strongSelf = self else { return }
    if error != nil {
      // print error message.
      return
    }
    let tripService = GMTCServices.shared().tripService
    // Create a tripModel instance for listening the update of the trip
    // specified by this trip name.
    let tripModel = tripService.tripModel(forTripName: tripName)
    // Create a journeySharingSession instance based on the tripModel
    let journeySharingSession = GMTCJourneySharingSession(tripModel: tripModel)
    // Add the journeySharingSession instance on the mapView for UI updating.
    strongSelf.mapView.show(journeySharingSession)
    // Register for the trip update events.
    tripModel.register(strongSelf)

    strongSelf.currentTripModel = tripModel
    strongSelf.currentJourneySharingSession = journeySharingSession
    strongSelf.hideLoadingView()
  }

  self.showLoadingView()
}

Objective-C

/*
 * MapViewController.m
 */
- (void)viewDidLoad {
  [super viewDidLoad];
  ...
  self.mapView = [[GMTCMapView alloc] initWithFrame:CGRectZero];
  self.mapView.delegate = self;
  [self.view addSubview:self.mapView];
}

// Handle the callback when the GMTCMapView did initialized.
- (void)mapViewDidInitializeCustomerState:(GMTCMapView *)mapview {
  self.mapView.pickupLocation = self.selectedPickupLocation;
  self.mapView.dropoffLocation = self.selectedDropoffLocation;

  __weak __typeof(self) weakSelf = self;
  [self startTripBookingWithPickupLocation:self.selectedPickupLocation
                           dropoffLocation:self.selectedDropoffLocation
                                completion:^(NSString *tripName, NSError *error) {
                                  __typeof(self) strongSelf = weakSelf;
                                  GMTCTripService *tripService = [GMTCServices sharedServices].tripService;
                                  // Create a tripModel instance for listening to updates to the trip specified by this trip name.
                                  GMTCTripModel *tripModel = [tripService tripModelForTripName:tripName];
                                  // Create a journeySharingSession instance based on the tripModel.
                                  GMTCJourneySharingSession *journeySharingSession =
                                    [[GMTCJourneySharingSession alloc] initWithTripModel:tripModel];
                                  // Add the journeySharingSession instance on the mapView for updating the UI.
                                  [strongSelf.mapView showMapViewSession:journeySharingSession];
                                  // Register for trip update events.
                                  [tripModel registerSubscriber:self];

                                  strongSelf.currentTripModel = tripModel;
                                  strongSelf.currentJourneySharingSession = journeySharingSession;
                                  [strongSelf hideLoadingView];
                                }];
    [self showLoadingView];
}

Einer Reise nicht mehr folgen

Sie folgen einer Reise nicht mehr, wenn sie abgeschlossen oder abgebrochen wurde. Das folgende Beispiel zeigt, wie Sie die Freigabe der aktiven Fahrt beenden.

Swift

/*
 * MapViewController.swift
 */
func cancelCurrentActiveTrip() {
  // Stop the tripModel
  self.currentTripModel.unregisterSubscriber(self)

  // Remove the journey sharing session from the mapView's UI stack.
  self.mapView.hide(journeySharingSession)
}

Objective-C

/*
 * MapViewController.m
 */
- (void)cancelCurrentActiveTrip {
  // Stop the tripModel
  [self.currentTripModel unregisterSubscriber:self];

  // Remove the journey sharing session from the mapView's UI stack.
  [self.mapView hideMapViewSession:journeySharingSession];
}

Streckenfortschritt aktualisieren

So verwalten Sie den Fortschritt einer Fahrt:

Auf Updates warten Ein Beispiel finden Sie unter Beispiel für das Abhören von Updates starten.
Updates zu Fahrten verarbeiten Ein Beispiel finden Sie unter Beispiel für die Verarbeitung von Fahrt-Updates.

Wenn eine Fahrt abgeschlossen oder abgebrochen wird, beenden Sie das Abrufen von Updates. Ein Beispiel finden Sie unter Beispiel für das Beenden des Empfangs von Updates.

Beispiel für das Warten auf Updates starten

Das folgende Beispiel zeigt, wie der tripModel-Callback registriert wird.

Swift

/*
 * MapViewController.swift
 */
override func viewDidLoad() {
  super.viewDidLoad()
  // Register for trip update events.
  self.currentTripModel.register(self)
}

Objective-C

/*
 * MapViewController.m
 */
- (void)viewDidLoad {
  [super viewDidLoad];
  // Register for trip update events.
  [self.currentTripModel registerSubscriber:self];
  ...
}

Beispiel für „Warten auf Ereignisse beenden“

Das folgende Beispiel zeigt, wie die Registrierung des tripModel-Callbacks aufgehoben wird.

Swift

/*
 * MapViewController.swift
 */
deinit {
  self.currentTripModel.unregisterSubscriber(self)
}

Objective-C

/*
 * MapViewController.m
 */
- (void)dealloc {
  [self.currentTripModel unregisterSubscriber:self];
  ...
}

Beispiel für die Verarbeitung von Fahrtaktualisierungen

Das folgende Beispiel zeigt, wie das GMTCTripModelSubscriber-Protokoll zum Verarbeiten von Callbacks implementiert wird, wenn der Status der Fahrt aktualisiert wird.

Swift

/*
 * MapViewController.swift
 */
func tripModel(_: GMTCTripModel, didUpdate trip: GMTSTrip?, updatedPropertyFields: GMTSTripPropertyFields) {
  // Update the UI with the new `trip` data.
  self.updateUI(with: trip)
}

func tripModel(_: GMTCTripModel, didUpdate tripStatus: GMTSTripStatus) {
  // Handle trip status did change.
}

func tripModel(_: GMTCTripModel, didUpdateActiveRouteRemainingDistance activeRouteRemainingDistance: Int32) {
  // Handle remaining distance of active route did update.
}

func tripModel(_: GMTCTripModel, didUpdateActiveRoute activeRoute: [GMTSLatLng]?) {
  // Handle trip active route did update.
}

func tripModel(_: GMTCTripModel, didUpdate vehicleLocation: GMTSVehicleLocation?) {
  // Handle vehicle location did update.
}

func tripModel(_: GMTCTripModel, didUpdatePickupLocation pickupLocation: GMTSTerminalLocation?) {
  // Handle pickup location did update.
}

func tripModel(_: GMTCTripModel, didUpdateDropoffLocation dropoffLocation: GMTSTerminalLocation?) {
  // Handle drop off location did update.
}

func tripModel(_: GMTCTripModel, didUpdatePickupETA pickupETA: TimeInterval) {
  // Handle the pickup ETA did update.
}

func tripModel(_: GMTCTripModel, didUpdateDropoffETA dropoffETA: TimeInterval) {
  // Handle the drop off ETA did update.
}

func tripModel(_: GMTCTripModel, didUpdateRemaining remainingWaypoints: [GMTSTripWaypoint]?) {
  // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}

func tripModel(_: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
  // Handle the error.
}

func tripModel(_: GMTCTripModel, didUpdateIntermediateDestinations intermediateDestinations: [GMTSTerminalLocation]?) {
  // Handle the intermediate destinations being updated.
}

func tripModel(_: GMTCTripModel, didUpdateActiveRouteTraffic activeRouteTraffic: GMTSTrafficData?) {
  // Handle trip active route traffic being updated.
}

Objective-C

/*
 * MapViewController.m
 */
#pragma mark - GMTCTripModelSubscriber implementation

- (void)tripModel:(GMTCTripModel *)tripModel
            didUpdateTrip:(nullable GMTSTrip *)trip
    updatedPropertyFields:(enum GMTSTripPropertyFields)updatedPropertyFields {
  // Update the UI with the new `trip` data.
  [self updateUIWithTrip:trip];
  ...
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateTripStatus:(enum GMTSTripStatus)tripStatus {
  // Handle trip status did change.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRouteRemainingDistance:(int32_t)activeRouteRemainingDistance {
   // Handle remaining distance of active route did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRoute:(nullable NSArray<GMTSLatLng *> *)activeRoute {
  // Handle trip active route did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateVehicleLocation:(nullable GMTSVehicleLocation *)vehicleLocation {
  // Handle vehicle location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdatePickupLocation:(nullable GMTSTerminalLocation *)pickupLocation {
  // Handle pickup location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateDropoffLocation:(nullable GMTSTerminalLocation *)dropoffLocation {
  // Handle drop off location did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdatePickupETA:(NSTimeInterval)pickupETA {
  // Handle the pickup ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateRemainingWaypoints:(nullable NSArray<GMTSTripWaypoint *> *)remainingWaypoints {
  // Handle updates to the pickup, dropoff or intermediate destinations of the trip.
}

- (void)tripModel:(GMTCTripModel *)tripModel didUpdateDropoffETA:(NSTimeInterval)dropoffETA {
  // Handle the drop off ETA did update.
}

- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(nullable NSError *)error {
  // Handle the error.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateIntermediateDestinations:
        (nullable NSArray<GMTSTerminalLocation *> *)intermediateDestinations {
  // Handle the intermediate destinations being updated.
}

- (void)tripModel:(GMTCTripModel *)tripModel
    didUpdateActiveRouteTraffic:(nullable GMTSTrafficData *)activeRouteTraffic {
  // Handle trip active route traffic being updated.
}

Fehler bei Fahrten beheben

Wenn Sie tripModel abonniert haben und ein Fehler auftritt, können Sie den Callback von tripModel abrufen, indem Sie die Delegatenmethode tripModel(_:didFailUpdateTripWithError:) implementieren. 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:

HTTP	RPC	Beschreibung
400	INVALID_ARGUMENT	Der Client hat einen ungültigen Namen für die Reise angegeben. Der Name der Reise muss dem Format `providers/{provider_id}/trips/{trip_id}` entsprechen. Die provider_id muss die ID des Cloud-Projekts sein, das dem Dienstanbieter gehört.
401	NICHT AUTHENTIFIZIERT	Dieser Fehler wird angezeigt, wenn keine gültigen Anmeldedaten vorhanden sind. Das kann beispielsweise der Fall sein, wenn das JWT-Token ohne eine Fahrt-ID signiert wurde oder das JWT-Token abgelaufen ist.
403	PERMISSION_DENIED	Dieser Fehler tritt auf, wenn der Client nicht die erforderlichen Berechtigungen hat (z. B. wenn ein Nutzer mit der Rolle „Consumer“ versucht, „updateTrip“ aufzurufen), wenn das JWT-Token ungültig ist oder wenn die API nicht für das Clientprojekt aktiviert ist. Das JWT-Token fehlt möglicherweise oder das Token ist mit einer Fahrt-ID signiert, die nicht mit der angeforderten Fahrt-ID übereinstimmt.
429	RESOURCE_EXHAUSTED	Das Ressourcenkontingent ist null oder die Trafficrate überschreitet das Limit.
503	UNAVAILABLE	Dienst nicht verfügbar: In der Regel ist der Server ausgefallen.
504	DEADLINE_EXCEEDED	Die Frist der Anfrage wurde überschritten. Dieser Fehler tritt nur auf, wenn für den Aufruf eine Frist festgelegt wurde, die kürzer ist als die Standardfrist der Methode (d. h., die angeforderte Frist reicht nicht aus, damit der Server die Anfrage bearbeitet), und die Anfrage nicht innerhalb der Frist abgeschlossen wurde.

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.

Swift

Die NSError wird in tripModel(_:didFailUpdateTripWithError:) zurückgerufen.

// Called when there is a trip update error.
func tripModel(_ tripModel: GMTCTripModel, didFailUpdateTripWithError error: Error?) {
  // Check to see if the error comes from gRPC.
  if let error = error as NSError?, error.domain == "io.grpc" {
    let gRPCErrorCode = error.code
    ...
  }
}

Objective-C

Die NSError wird in tripModel:didFailUpdateTripWithError: zurückgerufen.

// Called when there is a trip update error.
- (void)tripModel:(GMTCTripModel *)tripModel didFailUpdateTripWithError:(NSError *)error {
  // Check to see if the error comes from gRPC.
  if ([error.domain isEqualToString:@"io.grpc"]) {
    NSInteger gRPCErrorCode = error.code;
    ...
  }
}

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.

Statuscode	Beschreibung
ABORTED	Der Server hat das Senden der Antwort beendet. Das liegt normalerweise an einem Serverproblem.
CANCELLED	Der Server hat die ausgehende Antwort beendet. Das passiert normalerweise, wenn die App in den Hintergrund verschoben wird oder sich der Status in der Consumer-App ändert.
INTERRUPTED
DEADLINE_EXCEEDED	Der Server hat zu lange zum Antworten gebraucht.
UNAVAILABLE	Der Server war nicht verfügbar. Dies wird normalerweise durch ein Netzwerkproblem verursacht.

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. Die Verbindung wird jedoch erst wiederhergestellt, wenn Sie Maßnahmen ergreifen.

Statuscode	Beschreibung
INVALID_ARGUMENT	In der Consumer-App wurde ein ungültiger Fahrtenname angegeben. Der Fahrtenname muss dem Format `providers/{provider_id}/trips/{trip_id}` entsprechen.
NOT_FOUND	Die Reise wurde nie erstellt.
PERMISSION_DENIED	Die Consumer-App hat nicht die erforderlichen Berechtigungen. Dieser Fehler tritt in folgenden Fällen auf: Die Consumer-App hat keine Berechtigungen Das Consumer SDK ist für das Projekt in der Google Cloud Console nicht aktiviert. Der JWT-Token fehlt oder ist ungültig. Das JWT-Token ist mit einer Fahrt-ID signiert, die nicht der angeforderten Fahrt entspricht.
RESOURCE_EXHAUSTED	Das Ressourcenkontingent ist null oder die Rate des Traffics überschreitet das Tempolimit.
NICHT AUTHENTIFIZIERT	Die Anfrage konnte aufgrund eines ungültigen JWT-Tokens nicht authentifiziert werden. Dieser Fehler tritt auf, wenn das JWT-Token ohne eine Fahrt-ID signiert wurde oder wenn das JWT-Token abgelaufen ist.

Reisen auf iOS-Geräten verfolgen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Einer Reise folgen

Swift

Objective-C

Einer Reise nicht mehr folgen

Swift

Objective-C

Streckenfortschritt aktualisieren

Beispiel für das Warten auf Updates starten

Swift

Objective-C

Beispiel für „Warten auf Ereignisse beenden“

Swift

Objective-C

Beispiel für die Verarbeitung von Fahrtaktualisierungen

Swift

Objective-C

Fehler bei Fahrten beheben

Consumer SDK-Fehler beheben

Statuscodes extrahieren

Swift

Objective-C

Statuscodes interpretieren

Server- und Netzwerkfehler

Clientfehler

Reisen auf iOS-Geräten verfolgen