หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

ตั้งค่า Listener

หลังจากเริ่มต้น Driver SDK และสร้างอินสแตนซ์ GMTDRidesharingDriverAPI แล้ว คุณจะตั้งค่าเครื่องมือฟังเหตุการณ์เพื่อตรวจสอบความสําเร็จหรือความล้มเหลวของ การอัปเดตยานพาหนะที่ส่งไปยัง 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 on 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

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

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