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