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)

स्टैंडर्ड फ़्लीट इंजन अनुरोध का हेडर.

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 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 फ़ील्ड सेट नहीं होगा. अगर कोई कम से कम वैल्यू तय नहीं की गई है, तो ट्रैफ़िक का डेटा हमेशा लिया जाता है. ध्यान दें कि ट्रैफ़िक सिर्फ़ 'मांग पर राइड और डिलीवरी' सुविधा के ग्राहकों के लिए उपलब्ध है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 पॉलीलाइन कंप्रेशन एल्गोरिदम के साथ एन्कोड की गई पॉलीलाइन. डिकोड करने की सुविधा अभी तक उपलब्ध नहीं है.