הגדרת מאזינים
אחרי שמפעילים את 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
שולחת באופן אוטומטי עדכונים לגבי המסלול וזמני ההגעה המשוערים.
ה-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 שניות. עדכונים תכופים יותר עלולים לגרום לבקשות איטיות יותר ולשגיאות.