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

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

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

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

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

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

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

जगह की जानकारी के अपडेट चालू करें

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

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

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