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

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

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

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

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

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

• vehicleReporter:didSucceedVehicleUpdate

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

• 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 पर सेट करें. इसके बाद, 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

ध्यान दें: अगर डिवाइस की जगह की जानकारी के आखिरी अपडेट के बाद, डिवाइस की जगह में कोई बदलाव नहीं हुआ है, तो GMSRoadSnappedLocationProvider क्लास, जगह की जानकारी के अपडेट लगातार नहीं भेजती. उदाहरण के लिए, अगर कोई ड्राइवर कार में इंतज़ार कर रहा है. अगर आप जगह की जानकारी का नया अपडेट भेजना चाहते हैं और startUpdatingLocation को GMSRoadSnappedLocationProvider पर कॉल करने के बाद, GMTDDeliveryVehicleReporter को सुनने वाले व्यक्ति के तौर पर सेट करना चाहते हैं, तो आपको GMSRoadSnappedLocationProvider को रोकना और शुरू करना होगा.

(ज़रूरी नहीं) अपडेट का इंटरवल सेट करना

डिफ़ॉल्ट रूप से, locationTrackingEnabled को YES पर सेट करने पर, ड्राइवर SDK टूल 10 सेकंड के इंटरवल में Fleet Engine को जगह की जानकारी के अपडेट भेजता है. locationUpdateInterval वाले अपडेट के इंटरवल को बदलकर, कम से कम 5 सेकंड या ज़्यादा से ज़्यादा 60 सेकंड का किया जा सकता है. ज़्यादा बार अपडेट होने की वजह से, अनुरोधों और गड़बड़ियों की संख्या कम हो सकती है.