בקטע הזה מוסבר איך להכין את הרכב לנסיעות. חובה להשלים כל אחד מהשלבים הבאים לפני שהקצה העורפי יכול להתאים בין רכב לנסיעה.
הגדרת מאזינים
אחרי אתחול ה-SDK של מנהל ההתקן ויצירת GMTDRidesharingDriverAPI
תוכלו להגדיר פונקציות event listener למעקב אחרי ההצלחה או הכישלון של
עדכוני רכב נשלחו ל-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
האזנה לעדכונים על מיקום הרכב
SDK לניווט מספק עדכוני מיקום ל-Driver SDK באמצעות
כיתה אחת (GMSRoadSnappedLocationProvider
). כדי לקבל את העדכונים האלה, צריך להגדיר
להעלות את GMTDVehicleReporter
כמאזינים.
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