इस गाइड में, Fleet Engine से सीधे यात्रा का डेटा वापस पाने का तरीका बताया गया है. . अगर आपको यह तरीका अपनाना है, तो उपयोगकर्ताओं को बेहतर अनुभव देते हुए भी, Fleet का फ़ायदा उठाएं इंजन की सटीक और रीयल-टाइम में गाड़ी की जगह की जानकारी, ETA, और रूटिंग.
उपभोक्ता SDK टूल के इस्तेमाल के बारे में ज़्यादा जानने के लिए, मांग पर उपलब्ध खरीदारी के अनुभव की जानकारी देखें यात्राएं.
यात्रा की जानकारी वापस पाएं
सीधे Fleet Engine से यात्रा की जानकारी पाने के लिए, GetTrip
पर कॉल करें
तरीका है, जिसमें JOURNEY_SHARING_V1S
व्यू बताया गया है. RPC के लिए रेफ़रंस देखें या
आराम.
आपका सर्वर आम तौर पर हर यात्रा की स्थिति के लिए यात्रा सेवा की जांच करेगा
जब राइडर गाड़ी की प्रोग्रेस पर लगातार नज़र रख रहा हो. वाहन की जगह की जानकारी
अपडेट आम तौर पर हर 10 सेकंड में होते हैं और आपके सिस्टम को
एक जैसी दर. Trip.last_location.update_time
फ़ील्ड की निगरानी की जा सकती है, ताकि यह देखा जा सके कि क्या
GetTrip
को किए गए पिछले कॉल के बाद से कोई अपडेट आया है.
static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-A";
String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;
GetTripRequest getTripRequest =
GetTripRequest.newBuilder()
.setName(tripName)
.setView(JOURNEY_SHARING_V1S)
.build();
Trip trip = tripService.getTrip(getTripRequest);
नतीजे के तौर पर मिलने वाले Trip
ऑब्जेक्ट में, इन फ़ील्ड में सबसे नई जानकारी अपने-आप भर गई है
यात्रा के लिए उपलब्ध जानकारी:
name |
trip_status |
remaining_waypoints |
vehicle_id |
trip_type |
last_location |
number_of_passengers |
pickup_point |
view (== JOURNEY_SHARING_V1S) |
actual_pickup_point |
intermediate_destinations |
intermediate_destination_index |
pickup_time |
intermediate_destinations_version |
dropoff_point |
actual_dropoff_point |
dropoff_time |
|
यात्रा के बाकी वेपॉइंट वापस पाएं
यात्रा की इकाई में TripWaypoint
टाइप का एक दोहराया गया फ़ील्ड है. यह फ़ील्ड
इसमें वे सभी वेपॉइंट शामिल हैं जिनसे वाहन को पहले क्रम में यात्रा करनी होगी
यह यात्रा का आखिरी ड्रॉप-ऑफ़ पॉइंट है. 'गतिविधि शेयर करना' व्यू तय करना
शेष_waypoints[0] में अपडेट की गई जानकारी डालने के लिए फ़्लीट इंजन
TripWaypoint
. अन्य, गैर-यात्रा साझाकरण दृश्यों में, वेपॉइंट
आम तौर पर, असाइन किए गए वाहन की हाल की स्थिति की जानकारी मिलती है. ज़्यादा जानकारी के लिए,
RPC या REST के लिए रेफ़रंस हो.
ज़्यादा जानकारी के लिए, यहां यात्रा की स्थिति और वाहन के बचे हुए रास्ते देखें यात्राओं के बारे में जानकारी वाली गाइड.
यहां एक यात्रा के लिए remaining_waypoints
फ़ील्ड का एक उदाहरण दिया गया है, जिसे यात्रा A के लिए इस्तेमाल किया जाता है:
| |||||||||||||||||||||
|
एक के बाद एक होने वाली और शेयर की जाने वाली पूलिंग ट्रिप के साथ, इस सूची में वेपॉइंट शामिल हो सकते हैं
जो इस यात्रा से पहले हुए हैं. उदाहरण के लिए,
ऐसी स्थिति जहां यात्रा B, एक ही वाहन को यात्रा A के लिए असाइन की गई है. कॉन्टेंट बनाने
इसके बाद, यात्रा A के लिए remaining_waypoints
फ़ील्ड में, इस तरह से जानकारी अपने-आप भर जाएगी.
कम शब्दों में जानकारी देने के लिए, ज़्यादातर फ़ील्ड को शामिल नहीं किया गया है, लेकिन हो सकता है कि
पिछले उदाहरण के मुताबिक अपने-आप जानकारी भर जाएगी.
[0] | trip_id = "trip_A" |
---|---|
वेपॉइंट_टाइप = PICKUP_WAYPOINT_TYPE | |
[1] | Travel_id = "trip_B" |
वेपॉइंट_टाइप = PICKUP_WAYPOINT_TYPE | |
[2] | Travel_id = "trip_B" |
वेपॉइंट_टाइप = DROP_OFF_WAYPOINT_TYPE | |
[3] | trip_id = "trip_A" |
वेपॉइंट_टाइप = DROP_OFF_WAYPOINT_TYPE |
यात्रा B का remaining_waypoint
फ़ील्ड इसी तरह से भर जाएगा, लेकिन सिर्फ़
पहली तीन एंट्री होंगी, क्योंकि यात्रा A का ड्रॉप-ऑफ़ पॉइंट शामिल नहीं है
ट्रिप B के रूट का है.