Fahrzeug vorbereiten

In diesem Abschnitt wird beschrieben, wie Sie das Fahrzeug für Fahrten vorbereiten. Sie müssen die folgenden Schritte ausführen, bevor Ihr Backend ein Fahrzeug einer Fahrt zuordnen kann.

Listener einrichten

Nachdem Sie das Driver SDK initialisiert und eine GMTDRidesharingDriverAPI-Instanz erstellt haben, können Sie Event-Listener einrichten, um den Erfolg oder Misserfolg von Fahrzeugaktualisierungen zu überwachen, die an die Fleet Engine und Ihr Backend gesendet werden. Diese Listener können Aktionen in Ihrer Fahrer-App auslösen, z. B. den Fahrer benachrichtigen, wenn die Kommunikation mit Ihrem Backend fehlschlägt.

Auf Ereignisse zur Fahrzeugaktualisierung warten

Wenn der Fahrer Standortaktualisierungen in der Fahrer-App aktiviert, sendet das Driver SDK über die Klasse GMTDVehicleReporter regelmäßige Fahrzeugaktualisierungen an die Fleet Engine und das Kunden-Backend. Sie können die App so konfigurieren, dass sie auf Aktualisierungsereignisse reagiert, indem Sie das GMTDVehicleReporterListener-Protokoll einrichten.

Mit GMTDVehicleReporterListener können Sie die folgenden Ereignisse verarbeiten:

  • vehicleReporter:didSucceedVehicleUpdate

    Informiert die Fahrer-App darüber, dass die Backend-Dienste die Aktualisierung des Fahrzeugstandorts und ‑status erfolgreich empfangen haben.

  • vehicleReporter:didFailVehicleUpdate:withError

    Informiert den Listener darüber, dass ein Fahrzeugupdate fehlgeschlagen ist. Solange der Fahrer Standort-Updates aktiviert hat, sendet die Klasse GMTDVehicleReporter weiterhin die neuesten Daten an Fleet Engine.

Die folgenden Beispiele zeigen, wie Sie GMTDVehicleReporterListener einrichten, um diese Ereignisse zu verarbeiten:

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    ridesharingDriverAPI.vehicleReporter.add(self)
  }

  func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didSucceed vehicleUpdate: GMTDVehicleUpdate) {
    // Handle update succeeded.
  }

  func vehicleReporter(_ vehicleReporter: GMTDVehicleReporter, didFail vehicleUpdate: GMTDVehicleUpdate, withError error: Error) {
    // Handle update failed.
  }
}

Objective-C

/**
 *   SampleViewController.h
 */
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end

/**
 *   SampleViewController.m
 */
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
  GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // Assumes you have implemented the sample code up to this step.
  [ridesharingDriverAPI.vehicleReporter addListener:self];
}

- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didSucceedVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate {
  // Handle update succeeded.
}

- (void)vehicleReporter:(GMTDVehicleReporter *)vehicleReporter didFailVehicleUpdate:(GMTDVehicleUpdate *)vehicleUpdate withError:(NSError *)error {
  // Handle update failed.
}

@end

Updates zum Fahrzeugstandort abrufen

Das Navigation SDK stellt dem Driver SDK über die Klasse GMSRoadSnappedLocationProvider Standortaktualisierungen zur Verfügung. Wenn Sie diese Updates erhalten möchten, müssen Sie den GMTDVehicleReporter als Listener einrichten.

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    if let roadSnappedLocationProvider = mapView.roadSnappedLocationProvider {
      roadSnappedLocationProvider.add(ridesharingDriverAPI.vehicleReporter)
      roadSnappedLocationProvider.startUpdatingLocation()
    }
  }
}

Objective-C

/**
 *   SampleViewController.h
 */
@interface SampleViewController : UIViewController<GMTDVehicleReporterListener>
@end

/**
 *   SampleViewController.m
 */
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
  GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // Assumes you have implemented the sample code up to this step.
  [_mapView.roadSnappedLocationProvider addListener:ridesharingDriverAPI.vehicleReporter];
  [_mapView.roadSnappedLocationProvider startUpdatingLocation];
}

@end

Standort-Updates aktivieren

Wenn Sie Standort-Updates aktivieren möchten, setzen Sie locationTrackingEnabled in der Fahrer-App auf true für GMTDVehicleReporter. Die Klasse GMTDVehicleReporter sendet dann automatisch Standort-Updates an die Fleet Engine. Nachdem die Fleet Engine und die Backend-Dienste des Kunden das Fahrzeug einer Fahrt zugeordnet haben, sendet die Klasse GMTDVehicleReporter automatisch Routenaktualisierungen, wenn sich die GMSNavigator im Navigationsmodus befindet. Das ist der Fall, wenn ein Ziel über setDestinations festgelegt wurde.

Das Driver SDK legt die Route so fest, dass sie mit dem aktuellen Navigationspfad des Fahrers übereinstimmt. Damit die Standortaktualisierungen korrekt sind, muss der Wegpunkt in setDestinations mit dem Ziel in der Fleet Engine übereinstimmen.

Das folgende Beispiel zeigt, wie Standort-Updates aktiviert werden:

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = true
  }
}

Objective-C

/**
 *   SampleViewController.m
 */
#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
  GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // Assumes you have implemented the sample code up to this step.
  ridesharingDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}

@end

Aktualisierungsintervall festlegen

Wenn Sie locationTrackingEnabled auf true setzen, sendet das Driver SDK standardmäßig alle 10 Sekunden Fahrten- und Fahrzeugupdates an die Fleet Engine. Sie können das Aktualisierungsintervall mit locationUpdateInterval auf ein Mindestaktualisierungsintervall von 5 Sekunden oder maximal 60 Sekunden ändern. Häufigere Aktualisierungen können zu langsameren Anfragen und Fehlern führen.

Fahrzeugstatus auf „Online“ setzen

Nachdem Sie Standortaktualisierungen aktiviert haben, setzen Sie den Fahrzeugstatus auf ONLINE, damit das Fahrzeug für Suchanfragen in Fleet Engine verfügbar ist.

In den folgenden Beispielen wird gezeigt, wie der Fahrzeugstatus auf ONLINE gesetzt wird. Weitere Informationen finden Sie unter updateVehicleState.

Swift

import GoogleRidesharingDriver

private let providerID = "INSERT_YOUR_PROVIDER_ID"

class SampleViewController: UIViewController, GMTDVehicleReporterListener {
  private let mapView: GMSMapView

  override func viewDidLoad() {
    // Assumes you have implemented the sample code up to this step.
    ridesharingDriverAPI.vehicleReporter.update(.online)
  }
}

Objective-C

#import "SampleViewController.h"
#import "SampleAccessTokenProvider.h"
#import <GoogleRidesharingDriver/GoogleRidesharingDriver.h>

static NSString *const PROVIDER_ID = @"INSERT_YOUR_PROVIDER_ID";

@implementation SampleViewController {
  GMSMapView *_mapView;
}

- (void)viewDidLoad {
  // Assumes you have implemented the sample code up to this step.
  [ridesharingDriverAPI.vehicleReporter
                                   updateVehicleState:GMTDVehicleStateOnline];
}

@end

Nächste Schritte

Fahrtdetails festlegen