מכינים את הרכב

בקטע הזה מוסבר איך להכין את הרכב לנסיעות. עליכם להשלים כל אחד מהשלבים הבאים כדי שהקצה העורפי יוכל להתאים בין הרכב לנסיעה.

הגדרת מאזינים

אחרי שמפעילים את 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 כ-listen.

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, ה-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

המאמרים הבאים

הגדרת פרטי הנסיעה