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

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

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

אחרי אתחול ה-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.

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

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

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