इस सेक्शन में, वाहन को यात्राओं के लिए तैयार करने का तरीका बताया गया है. आपका बैकएंड किसी वाहन को किसी यात्रा से मैच कर सके, इसके लिए आपको यहां दिए गए हर चरण को पूरा करना होगा.
Listener को सेट अप करना
Driver SDK टूल, बैकग्राउंड में कार्रवाइयां करता है. इसलिए, गड़बड़ियां, चेतावनियां या डीबग मैसेज जैसे कुछ इवेंट होने पर सूचनाएं ट्रिगर करने के लिए, DriverStatusListener
का इस्तेमाल करें. गड़बड़ियां कुछ समय के लिए हो सकती हैं (जैसे, BACKEND_CONNECTIVITY_ERROR
). इसके अलावा, इनकी वजह से जगह की जानकारी के अपडेट हमेशा के लिए बंद हो सकते हैं. उदाहरण के लिए, अगर आपको VEHICLE_NOT_FOUND
गड़बड़ी का मैसेज मिलता है, तो इसका मतलब है कि कॉन्फ़िगरेशन में कोई गड़बड़ी है.
यहां दिए गए उदाहरण में, DriverStatusListener
को लागू करने का तरीका बताया गया है:
class MyStatusListener implements DriverStatusListener {
/** Called when background status is updated, during actions such as location reporting. */
@Override
public void updateStatus(
StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
// Existing implementation
if (cause != null && cause instanceof StatusRuntimeException) {
if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
// NOT_FOUND gRPC exception thrown by Fleet Engine.
}
}
}
}
DriverContextBuilder.setDriverStatusListener(new MyStatusListener());
जगह की जानकारी के अपडेट पाने की सुविधा चालू करना
लिसनर सेट अप करने के बाद, जगह की जानकारी के अपडेट पाने की सुविधा को इस तरह चालू करें:
Java
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Kotlin
val reporter = ...
reporter.enableLocationTracking()
अपडेट इंटरवल सेट करना
डिफ़ॉल्ट रूप से, Driver SDK टूल, वाहन की स्थिति ONLINE
होने पर, 10 सेकंड के अंतराल पर जगह की जानकारी के अपडेट भेजता है. reporter.setLocationReportingInterval(long, TimeUnit)
का इस्तेमाल करके, इस इंटरवल को बदला जा सकता है. अपडेट करने के लिए, कम से कम पांच सेकंड का इंटरवल होना चाहिए. बार-बार अपडेट करने से, अनुरोधों में ज़्यादा समय लग सकता है और गड़बड़ियां हो सकती हैं.
वाहन की स्थिति को 'ऑनलाइन' पर सेट करना
जगह की जानकारी के अपडेट चालू करने पर, वाहन की स्थिति को ONLINE
पर सेट किया जा सकता है, ताकि वाहन को Fleet Engine में SearchVehicles
क्वेरी के लिए उपलब्ध कराया जा सके. Driver SDK टूल, जगह की जानकारी के अपडेट के साथ-साथ वाहन की अपडेट की गई स्थिति भी भेजता है.
वाहन की स्थिति को सीधे Driver SDK या Fleet Engine के सर्वर में सेट किया जा सकता है. ज़्यादा जानकारी के लिए, वाहन की जानकारी अपडेट करना लेख पढ़ें.
यहां दिए गए उदाहरणों में, Driver SDK में वाहन की स्थिति को ऑनलाइन पर सेट करने का तरीका बताया गया है:
Java
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);
Kotlin
val reporter = ...
reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)
StatusListener
, वाहन की स्थिति अपडेट करते समय होने वाली किसी भी गड़बड़ी की रिपोर्ट भी करता है.