เตรียมยานพาหนะให้พร้อม

ส่วนนี้จะแสดงวิธีเตรียมรถให้พร้อมออกเดินทาง คุณต้องทําตามขั้นตอนต่อไปนี้ให้เสร็จสมบูรณ์ก่อนแบ็กเอนด์จะจับคู่ยานพาหนะกับการเดินทางได้

ตั้งค่า Listeners

หลังจากเริ่มต้น Driver SDK และสร้างGMTDRidesharingDriverAPI อินสแตนซ์แล้ว คุณสามารถตั้งค่า Listeners เหตุการณ์เพื่อตรวจสอบความสําเร็จหรือไม่สําเร็จของการอัปเดตยานพาหนะที่ส่งไปยัง Fleet Engine และแบ็กเอนด์ โปรแกรมฟังเหล่านี้สามารถทริกเกอร์การดำเนินการภายในแอปคนขับ เช่น การแจ้งเตือนคนขับหากการสื่อสารกับแบ็กเอนด์ไม่สำเร็จ

รอรับเหตุการณ์การอัปเดตยานพาหนะ

เมื่อคนขับเปิดใช้การอัปเดตตำแหน่งในแอปคนขับ Driver 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 จะส่งการอัปเดตตำแหน่งไปยัง Driver SDK ผ่านคลาส GMSRoadSnappedLocationProvider หากต้องการรับข้อมูลอัปเดตดังกล่าว คุณต้องตั้งค่า GMTDVehicleReporter เป็นผู้ฟัง

หมายเหตุ: หากอุปกรณ์ไม่ได้เคลื่อนไหวนับตั้งแต่การอัปเดตตำแหน่งครั้งล่าสุด คลาส GMSRoadSnappedLocationProvider จะไม่ส่งการอัปเดตตำแหน่งอย่างต่อเนื่องเพื่อประสิทธิภาพที่ดียิ่งขึ้น เช่น หากคนขับกำลังรออยู่ในรถ หากต้องการส่งการอัปเดตตำแหน่งใหม่และตั้งค่า GMTDVehicleReporter เป็นผู้ฟังหลังจากเรียกใช้ startUpdatingLocation ใน GMSRoadSnappedLocationProvider คุณต้องหยุดและเริ่ม GMSRoadSnappedLocationProvider

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

Driver 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 แล้ว Driver SDK จะส่งการอัปเดตการเดินทางและยานพาหนะไปยัง Fleet Engine ทุก 10 วินาที คุณสามารถเปลี่ยนช่วงเวลาการอัปเดตด้วย 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

ขั้นตอนถัดไป

ตั้งค่ารายละเอียดการเดินทาง