此页面由 Cloud Translation API 翻译。

准备好车辆

本部分介绍了如何准备好车辆以便出行。您必须完成以下每个步骤，您的后端才能将车辆与行程匹配。

设置监听器

初始化驱动程序 SDK 并创建 GMTDRidesharingDriverAPI 之后例如，您可以设置事件监听器来监控将车辆更新发送到 Fleet Engine 和您的后端。这些监听器触发操作，例如，在以下情况发生时通知驾驶员：与后端的通信失败。

监听车辆更新事件

当驾驶员在驾驶应用中启用位置信息更新时，驱动程序 SDK 定期向 Fleet Engine 和客户发送车辆更新信息 GMTDVehicleReporter 类对后端进行调用。您可以让应用做出响应通过设置 GMTDVehicleReporterListener 协议来更新事件。

借助 GMTDVehicleReporterListener，您可以处理以下事件：

vehicleReporter:didSucceedVehicleUpdate

通知驱动程序应用后端服务已成功收到车辆位置和状态更新。
vehicleReporter:didFailVehicleUpdate:withError

通知监听器车辆更新失败。只要驾驶员有启用位置信息更新，GMTDVehicleReporter 类会继续发送将最新数据传输到 Fleet Engine。

以下示例展示了如何将 GMTDVehicleReporterListener 设置为处理以下事件：

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

监听车辆位置信息更新

Navigation SDK 通过 GMSRoadSnappedLocationProvider 类。要接收这些更新，您必须将向上调用 GMTDVehicleReporter 作为监听器。

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

启用位置信息更新

若要启用位置信息更新，请将已开启的 locationTrackingEnabled 设为 true GMTDVehicleReporter。然后是 GMTDVehicleReporter 类自动将位置更新发送到 Fleet Engine。部署了 Fleet Engine 客户后端服务匹配并将车辆分配给行程， GMTDVehicleReporter 类会在发生以下情况时自动发送路线更新： GMSNavigator 处于导航模式，即通过 setDestinations。

驱动程序 SDK 会设置与驾驶员的当前导航路径匹配的路线。接收者确保位置信息更新准确无误，请在 setDestinations 中设置匹配的航点 Fleet Engine 中的目标位置。

以下示例展示了如何启用位置信息更新：

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

设置更新间隔

默认情况下，当您将 locationTrackingEnabled 设置为 true 时，驱动程序 SDK 会每隔 10 秒向 Fleet Engine 发送行程和车辆更新。您可以将 locationUpdateInterval 的更新间隔更改为最短更新时间为 5 秒或最长 60 秒。更新频率可能会更高会导致请求速度变慢和错误

将车辆状态设为在线

启用位置信息更新后，将车辆状态设置为 ONLINE， Fleet Engine 中的搜索查询。

以下示例展示了如何将车辆状态设置为 ONLINE。对于详情，请参阅 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

后续步骤

设置行程详细信息