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

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

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

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

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

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

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

• vehicleReporter:didSucceedVehicleUpdate

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

• 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

वाहन की जगह की जानकारी के अपडेट सुनना

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

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

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