Method: providers.trips.get

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• PolylineFormatType

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

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

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 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
remainingWaypointsVersion	string (Timestamp format) उस कम से कम टाइमस्टैंप (एक्सक्लूज़िव) के बारे में बताता है जिसके लिए Trip.remaining_waypoints को वापस पाया जाता है. अगर इस टाइमस्टैंप के बाद इनमें कोई बदलाव नहीं हुआ है, तो जवाब में remainingWaypoints सेट नहीं किए गए हैं. अगर इस फ़ील्ड के बारे में कोई जानकारी नहीं दी गई है, तो remainingWaypoints हमेशा लिया जाता है. आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
remainingWaypointsRouteVersion	string (Timestamp format) उस कम से कम टाइमस्टैंप (एक्सक्लूज़िव) के बारे में बताता है जिसके लिए Trip.remaining_waypoints.traffic_to_waypoint और Trip.remaining_waypoints.path_to_waypoint डेटा वापस पाया जाता है. अगर इस टाइमस्टैंप के बाद डेटा में कोई बदलाव नहीं हुआ है, तो जवाब में ऊपर दिए गए फ़ील्ड सेट नहीं किए जाते. अगर remainingWaypointsRouteVersion की वैल्यू नहीं दी गई है, तो ट्रैफ़िक और पाथ हमेशा वापस पाया जाता है. आरएफ़सी3339 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

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

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

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

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

PolylineFormatType

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

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