सीधे Fleet Engine से यात्रा का डेटा वापस पाएं

इस गाइड में, 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 के लिए इस्तेमाल किया जाता है:

[0] location.point = trips.pickup_point.point
trip_id = "trip_A"
waypoint_type = PICKUP_WAYPOINT_TYPE
path_to_waypoint = LatLng[] पिक अप के लिए, बाकी रास्ते से पहला LatLng
पिक अप के लिए, बाकी रास्ते से दूसरा LatLng
...
पिक अप के लिए बचे हुए पाथ से आखिरी LatLng
pickup_point, अगर पिछले से अलग है
traffic_data
Range_meters = पिक अप के लिए path_to_waypoint के आस-पास मौजूद वाहन_जगह से दूरी
ईटीए = अपडेट किया गया ETA
अवधि = अपडेट किया गया समय
[1] location.point = trips.dropoff_point.point
trip_id = "trip_A"
वेपॉइंट_टाइप = DROP_OFF_WAYPOINT_TYPE
path_to_waypoint = LatLng[] ड्रॉप ऑफ़ लेग से पहला LatLng
ड्रॉप ऑफ़ लेग से दूसरा LatLng
...
ड्रॉप ऑफ़ लेग से आखिरी LatLng
ड्रॉप-ऑफ़_पॉइंट, अगर आखिरी से अलग है
traffic_data
दूरी_meters = path_to_waypoint पर पिकअप से ड्रॉपऑफ़ की दूरी
ईटीए = अपडेट किया गया ETA
अवधि = ड्रॉप-ऑफ़ लेग की अवधि

एक के बाद एक होने वाली और शेयर की जाने वाली पूलिंग ट्रिप के साथ, इस सूची में वेपॉइंट शामिल हो सकते हैं जो इस यात्रा से पहले हुए हैं. उदाहरण के लिए, ऐसी स्थिति जहां यात्रा 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 के रूट का है.