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

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

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

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

כשהנהג מפעיל את עדכוני המיקום באפליקציית הנהג, ה-Driver SDK שולח עדכונים סדירים של הרכב ל-Fleet Engine ולקצה העורפי של הלקוח באמצעות הכיתה 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. לאחר מכן, העדכונים של המיקום יישלחו באופן אוטומטי ל-Fleet Engine על ידי הכיתה GMTDDeliveryVehicleReporter. בנוסף, כשה-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, ה-SDK של Drive שולח עדכוני מיקום ל-Fleet Engine במרווחי זמן של 10 שניות. אפשר לשנות את מרווח העדכון עם locationUpdateInterval למרווח עדכון מינימלי של 5 שניות או 60 שניות לכל היותר. עדכונים תכופים יותר עלולים לגרום לבקשות איטיות יותר ולשגיאות.