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