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

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

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

वाहन के अपडेट से जुड़े इवेंट सुनना

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

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

  • vehicleReporter:didSucceedVehicleUpdate

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

  • vehicleReporter:didFailVehicleUpdate:withError

    यह सूचना देता है कि वाहन की जानकारी अपडेट नहीं हो सकी. जब तक ड्राइवर के पास जगह की जानकारी के अपडेट चालू किए गए, GMTDDeliveryVehicleReporter क्लास जारी है का इस्तेमाल करें.

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

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

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

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