Method: providers.trips.get

किसी एक यात्रा के बारे में जानकारी पाना.

एचटीटीपी अनुरोध

GET https://fleetengine.googleapis.com/v1/{name=providers/*/trips/*}

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. यह providers/{provider}/trips/{trip} फ़ॉर्मैट में होना चाहिए. प्रोवाइडर, उस Google Cloud प्रोजेक्ट का प्रोजेक्ट आईडी (उदाहरण के लिए, sample-cloud-project) होना चाहिए जिसका यह कॉल करने वाला सेवा खाता सदस्य है.

क्वेरी पैरामीटर

पैरामीटर
header

object (RequestHeader)

Fleet Engine के अनुरोध का स्टैंडर्ड हेडर.
view

enum (TripView)

ट्रिप फ़ील्ड का सबसेट, जिसे दिखाना है और उसका विश्लेषण.
currentRouteSegmentVersion

string (Timestamp format)

इससे उस टाइमस्टैंप का पता चलता है जिसके बाद का Trip.route या Trip.current_route_segment डेटा वापस पाया जा सकता है. अगर इस टाइमस्टैंप के बाद, रास्ते का डेटा नहीं बदला है, तो जवाब में रास्ता फ़ील्ड सेट नहीं किया जाता. अगर कम से कम डेटा की संख्या तय नहीं की गई है, तो रूट का डेटा हमेशा वापस पाया जाता है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
remainingWaypointsVersion

string (Timestamp format)

उस कम से कम टाइमस्टैंप (एक्सक्लूज़िव) के बारे में बताता है जिसके लिए Trip.remaining_waypoints को वापस पाया जाता है. अगर इस टाइमस्टैंप के बाद इनमें कोई बदलाव नहीं हुआ है, तो जवाब में remainingWaypoints सेट नहीं किए गए हैं. अगर इस फ़ील्ड में कोई वैल्यू नहीं दी गई है, तो remainingWaypoints हमेशा वापस पाया जाता है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
routeFormatType

enum (PolylineFormatType)

दिखाया गया मौजूदा रूट फ़ॉर्मैट, LAT_LNG_LIST_TYPE (Trip.route में) या ENCODED_POLYLINE_TYPE (Trip.current_route_segment में). डिफ़ॉल्ट रूप से, LAT_LNG_LIST_TYPE दिखता है.
currentRouteSegmentTrafficVersion

string (Timestamp format)

उस कम से कम टाइमस्टैंप (एक्सक्लूज़िव) के बारे में बताता है जिसके लिए Trip.current_route_segment_traffic को वापस पाया जाता है. अगर इस टाइमस्टैंप के बाद ट्रैफ़िक डेटा में कोई बदलाव नहीं हुआ है, तो जवाब में currentRouteSegmentTraffic फ़ील्ड सेट नहीं किया जाता. अगर ट्रैफ़िक का कोई थ्रेशोल्ड तय नहीं किया गया है, तो ट्रैफ़िक डेटा हमेशा वापस पाया जा सकता है. ध्यान दें कि ट्रैफ़िक सिर्फ़ On-demand Rides and Deliveries Solution के ग्राहकों के लिए उपलब्ध है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
remainingWaypointsRouteVersion

string (Timestamp format)

उस कम से कम टाइमस्टैंप (एक्सक्लूज़िव) के बारे में बताता है जिसके लिए Trip.remaining_waypoints.traffic_to_waypoint और Trip.remaining_waypoints.path_to_waypoint डेटा वापस पाया जाता है. अगर इस टाइमस्टैंप के बाद डेटा में कोई बदलाव नहीं हुआ है, तो जवाब में ऊपर दिए गए फ़ील्ड सेट नहीं किए जाते. अगर remainingWaypointsRouteVersion की वैल्यू नहीं दी गई है, तो ट्रैफ़िक और पाथ हमेशा वापस पाया जाता है.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में Trip का एक इंस्टेंस शामिल किया जाता है.

PolylineFormatType

पॉलीलाइन फ़ॉर्मैट का टाइप.

Enums
UNKNOWN_FORMAT_TYPE फ़ॉर्मैट की जानकारी नहीं दी गई है या वह अज्ञात है.
LAT_LNG_LIST_TYPE google.type.LatLng की सूची.
ENCODED_POLYLINE_TYPE पॉलीलाइन को कंप्रेस करने वाले एल्गोरिदम से एन्कोड की गई पॉलीलाइन. फ़िलहाल, डिकोड करने की सुविधा उपलब्ध नहीं है.