इस सेक्शन में, वाहन को यात्राओं के लिए तैयार करने का तरीका बताया गया है. किसी वाहन को यात्रा के साथ दिखाने से पहले, आपको नीचे दिया गया हर चरण पूरा करना होगा.
Listener को सेट अप करना
ड्राइवर 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
पर सेट किया जा सकता है. इससे, फ़्लीट इंजन में SearchVehicles
की क्वेरी के लिए गाड़ी उपलब्ध हो पाएगी. ड्राइवर SDK टूल, वाहन की अपडेट की गई स्थिति और जगह की जानकारी भेजता है.
वाहन की स्थिति को सीधे Driver SDK या Fleet Engine के सर्वर में सेट किया जा सकता है. ज़्यादा जानकारी के लिए, वाहन की जानकारी अपडेट करना लेख पढ़ें.
नीचे दिए गए उदाहरणों में, ड्राइवर SDK टूल में वाहन की स्थिति को ऑनलाइन पर सेट करने का तरीका बताया गया है:
Java
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);
Kotlin
val reporter = ...
reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)
वाहन की स्थिति अपडेट करते समय होने वाली गड़बड़ियों के बारे में भी StatusListener
रिपोर्ट में बताया जाएगा.