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

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

אחרי שמפעילים את Driver SDK ויוצרים מכונה של GMTDDeliveryDriverAPI, אפשר להגדיר רכיבי event listener כדי לעקוב אחרי ההצלחה או הכישלון של עדכוני הרכב שנשלחים ל-Fleet Engine ול-backend. המאזינים האלה יכולים להפעיל פעולות באפליקציה של הנהג, למשל להודיע לנהג אם התקשורת עם הקצה העורפי נכשלה.

האזנה לאירועים של עדכוני רכב

כשהנהג מפעיל עדכוני מיקום באפליקציית הנהג, ה-Driver SDK שולח עדכונים שוטפים על הרכב ל-Fleet Engine ול-backend של הלקוח דרך הכיתה GMTDDeliveryVehicleReporter. כדי שהאפליקציה תגיב לאירועי עדכון, אתם יכולים להגדיר את הפרוטוקול GMTDVehicleReporterListener.

בעזרת GMTDVehicleReporterListener, אתם יכולים לטפל באירועים הבאים:

  • vehicleReporter:didSucceedVehicleUpdate

    מודיעה לאפליקציית הנהג ששירותי הקצה העורפי קיבלו את עדכון המיקום והמצב של הרכב.

  • vehicleReporter:didFailVehicleUpdate:withError

    הודעה למאזין שעדכון הרכב נכשל. כל עוד הנהג הפעיל את עדכון לגבי מיקום, המחלקה GMTDDeliveryVehicleReporter ממשיכה לשלוח את הנתונים העדכניים ביותר אל 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.
    deliveryDriverAPI.vehicleReporter.add(self)
  }

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

  func vehicleReporter(_ vehicleReporter: GMTDDeliveryVehicleReporter, 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 IMPLEMENTED HAVE THE SAMPLE CODE UP TO THIS STEP.
  [delivervehicleReporter addListener:self];
}

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

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

@end

הפעלת עדכונים לגבי מיקום

כדי להפעיל עדכונים לגבי מיקום, באפליקציית הנהג ב-GMTDDeliveryVehicleReporter, מגדירים את locationTrackingEnabled לערך YES. לאחר מכן, המחלקה GMTDDeliveryVehicleReporter שולחת באופן אוטומטי עדכוני מיקום אל Fleet Engine. בנוסף, כשהאפליקציה GMSNavigator נמצאת במצב ניווט, כלומר כשיעד מוגדר באמצעות setDestinations, המחלקה GMTDDeliveryVehicleReporter שולחת באופן אוטומטי עדכונים לגבי המסלול וזמן ההגעה המשוער.

ה-Driver SDK מגדיר את המסלול כך שיתאים למסלול הניווט הנוכחי של הנהג. כדי לוודא שהעדכונים לגבי המיקום מדויקים, צריך להגדיר את נקודת הציון ב--setDestinations:callback: כך שתתאים ליעד ב-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.
    deliveryDriverAPI.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.
  deliveryDriverAPI.vehicleReporter.locationTrackingEnabled = YES;
}

@end

(אופציונלי) הגדרת מרווח הזמן לעדכון

כברירת מחדל, כשמגדירים את locationTrackingEnabled לערך YES, ה-Driver SDK שולח עדכוני מיקום ל-Fleet Engine במרווחים של 10 שניות. אפשר לשנות את מרווח הזמן לעדכון באמצעות locationUpdateInterval למרווח זמן מינימלי של 5 שניות או למרווח זמן מקסימלי של 60 שניות. עדכונים תכופים יותר עלולים לגרום לבקשות איטיות יותר ולשגיאות.