गाड़ी तैयार रखें

लिसनर सेट अप करना

Driver SDK को शुरू करने और GMTDDeliveryDriverAPI इंस्टेंस बनाने के बाद, इवेंट लिसनर सेट अप किए जा सकते हैं. इनसे, Fleet Engine और आपके बैकएंड को भेजे गए वाहन के अपडेट के सफल या असफल होने की निगरानी की जा सकती है. ये लिसनर, आपके ड्राइवर ऐप्लिकेशन में कार्रवाइयां ट्रिगर कर सकते हैं. जैसे, अगर आपके बैकएंड से कम्यूनिकेट नहीं किया जा सकता, तो ड्राइवर को सूचना देना.

वाहन के अपडेट से जुड़े इवेंट को मॉनिटर करने की अनुमति

जब ड्राइवर, ड्राइवर ऐप्लिकेशन में जगह की जानकारी के अपडेट चालू करता है, तब Driver SDK, Fleet Engine और ग्राहक के बैकएंड को वाहन के अपडेट भेजता है. ये अपडेट, GMTDDeliveryVehicleReporter क्लास के ज़रिए भेजे जाते हैं. GMTDVehicleReporterListener प्रोटोकॉल सेट अप करके, ऐप्लिकेशन को अपडेट इवेंट के बारे में सूचनाएं पाने की सुविधा दी जा सकती है.

GMTDVehicleReporterListener की मदद से, इन इवेंट को मैनेज किया जा सकता है:

• vehicleReporter:didSucceedVehicleUpdate

  यह कुकी, Driver ऐप्लिकेशन को सूचना देती है कि बैकएंड सेवाओं को वाहन की जगह और स्थिति के अपडेट मिल गए हैं.

• vehicleReporter:didFailVehicleUpdate:withError

  इस कुकी से सुनने वाले को पता चलता है कि वाहन का अपडेट पूरा नहीं हुआ. जब तक ड्राइवर के लिए जगह की जानकारी अपडेट करने की सुविधा चालू रहती है, तब तक GMTDDeliveryVehicleReporter क्लास, Fleet Engine को नया डेटा भेजती रहती है.

यहां दिए गए उदाहरण में, इन इवेंट को मैनेज करने के लिए GMTDVehicleReporterListener को सेट अप करने का तरीका बताया गया है:

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.
  }
}

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 नेविगेशन मोड में होता है, तब GMTDDeliveryVehicleReporter क्लास रास्ते और ईटीए के अपडेट अपने-आप भेजती है. नेविगेशन मोड तब चालू होता है, जब setDestinations के ज़रिए कोई डेस्टिनेशन सेट किया जाता है.

Driver SDK, ड्राइवर के मौजूदा नेविगेशन पाथ से मैच करने के लिए रूट सेट करता है. जगह की सटीक जानकारी अपडेट करने के लिए, -setDestinations:callback: में वेपॉइंट सेट करें, ताकि वह Fleet Engine में मौजूद डेस्टिनेशन से मेल खाए.

यहां दिए गए उदाहरण में, जगह की जानकारी के अपडेट चालू करने का तरीका बताया गया है:

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

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 सेकंड पर सेट किया जा सकता है. बार-बार अपडेट करने से, अनुरोधों को प्रोसेस होने में ज़्यादा समय लग सकता है और गड़बड़ियां हो सकती हैं.