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

इस सेक्शन में, वाहन को यात्राओं के लिए तैयार करने का तरीका बताया गया है. किसी वाहन को यात्रा के साथ दिखाने से पहले, आपको नीचे दिया गया हर चरण पूरा करना होगा.

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

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

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

जब ड्राइवर ऐप्लिकेशन में जगह की जानकारी अपडेट करने की सुविधा चालू करता है, तब ड्राइवर का 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 टूल, GMSRoadSnappedLocationProvider क्लास की मदद से, ड्राइवर SDK टूल को जगह की जानकारी के अपडेट देता है. ये अपडेट पाने के लिए, आपको GMTDVehicleReporter को लिसनर के तौर पर सेट अप करना होगा.

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

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

आगे क्या करना है

यात्रा की जानकारी सेट करना