REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

सिर्फ़ आउटपुट के लिए. "providers/{provider}/trips/{trip}" फ़ॉर्मैट में

string

इस यात्रा के लिए जा रहे वाहन का आईडी.

enum (TripStatus)

यात्रा की मौजूदा स्थिति.

enum (TripType)

यात्रा किस तरह की है.

object (TerminalLocation)

वह जगह जहां ग्राहक से पता चलता है कि उसे पिक अप किया जाएगा.

object (StopLocation)

सिर्फ़ इनपुट. उस जगह की असल जानकारी जहां खरीदार को पिक अप किया गया था और जहां से उसे पिक अप किया गया था. इस फ़ील्ड पर, डिलीवरी की सेवा देने वाली कंपनी को पिकअप की असल जानकारी के बारे में सुझाव या राय दी जा सकती है.

object (StopLocation)

सिर्फ़ इनपुट. पिकअप पॉइंट पर ड्राइवर के पहुंचने का असल समय और जगह की जानकारी. इस फ़ील्ड की मदद से सेवा देने वाली कंपनी, पिकअप पॉइंट पर पहुंचने के समय की असल जानकारी के बारे में सुझाव दे सकती है.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. या तो अनुमानित समय, जब राइडर को पिक अप किया जाएगा या वह असल समय जब उसे पिक अप किया जाएगा.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (TerminalLocation)

यात्रा के अनुरोध के क्रम में बीच के स्टॉप (पिकअप और ड्रॉप-ऑफ़ के अलावा). शुरुआत में, यह सुविधा शेयर की गई यात्राओं के लिए उपलब्ध नहीं होगी.

string (Timestamp format)

यह बताता है कि पिछली बार intermediateDestinations में कब बदलाव किया गया था. आपके सर्वर को यह वैल्यू कैश मेमोरी में सेव करनी चाहिए. साथ ही, intermediateDestinationIndex को अपडेट करते समय, इसे UpdateTripRequest में पास करना चाहिए, ताकि intermediateDestinations में कोई बदलाव न हो.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

integer

TripStatus के ENROUTE_TO_INTERMEDIATE_DESTINATION होने पर, [0..N-1] के बीच की संख्या से पता चलता है कि वाहन किस इंटरमीडिएट डेस्टिनेशन से होकर गुज़रेगा. जब TripStatus, ARRIVED_AT_INTERMEDIATE_DESTINATION पर हो, तो [0..N-1] के बीच की संख्या से पता चलता है कि वाहन किस इंटरमीडिएट डेस्टिनेशन पर है. सेवा देने वाली कंपनी यह वैल्यू सेट करती है. अगर कोई intermediateDestinations नहीं है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है.

object (StopLocation)

सिर्फ़ इनपुट. किसी इंटरमीडिएट डेस्टिनेशन पर ड्राइवर के आने का असल समय और जगह. इस फ़ील्ड की मदद से, सेवा देने वाली कंपनी को इंटरमीडिएट डेस्टिनेशन पर पहुंचने के बारे में सुझाव दिया जा सकता है.

object (StopLocation)

सिर्फ़ इनपुट. किसी इंटरमीडिएट डेस्टिनेशन से, खरीदार को पिक अप किए जाने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वे इंटरमीडिएट डेस्टिनेशन पर पिकअप की असल जानकारी के बारे में सुझाव दे सकें.

object (TerminalLocation)

वह जगह जहां ग्राहक संकेत देता है कि उसे वहां से हटा दिया जाएगा.

object (StopLocation)

सिर्फ़ इनपुट. उस समय और जगह की जानकारी, जब ग्राहक को सेवा से हटाया गया था. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह ड्रॉप-ऑफ़ की असल जानकारी के बारे में सुझाव दे सके.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह अनुमानित समय जब राइडर को आखिरी मंज़िल पर उतारा जाएगा या उसके रवाना होने का असल समय.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

सिर्फ़ आउटपुट के लिए. मौजूदा जगह से ड्रॉप-ऑफ़ पॉइंट तक का पूरा रास्ता (इसमें शामिल है). इस पाथ में दूसरी यात्राओं के वेपॉइंट शामिल हो सकते हैं.

object (TripWaypoint)

इस फ़ील्ड में यात्रा के लिए वेपॉइंट को मैन्युअल तरीके से क्रम में लगाया जा सकता है. इसमें असाइन किए गए वाहन के लिए बाकी सभी वेपॉइंट मौजूद होते हैं. साथ ही, इस यात्रा के लिए पिक अप और ड्रॉप-ऑफ़ वेपॉइंट भी होते हैं. अगर यात्रा किसी वाहन को असाइन नहीं की गई है, तो फ़्लीट इंजन इस फ़ील्ड को अनदेखा कर देता है. निजता की वजहों से, इस फ़ील्ड को सर्वर से सिर्फ़ trips.update और trips.create कॉल के दौरान भरा जाता है, trips.get कॉल पर नहीं.

object (LatLng)

सिर्फ़ आउटपुट के लिए. बचे हुए वेपॉइंट में पहली एंट्री के लिए, इस यात्रा का अनुमानित रास्ता. ध्यान दें कि पहला वेपॉइंट किसी दूसरी यात्रा से जुड़ा हो सकता है.

string

सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट के लिए कोड में बदला गया पाथ.

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है. डिकोड करने की सुविधा अभी तक उपलब्ध नहीं है.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार रास्ते में कब बदलाव किया गया था.

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (ConsumableTrafficPolyline)

सिर्फ़ आउटपुट के लिए. यह currentRouteSegment के आस-पास के ट्रैफ़िक की स्थिति के बारे में बताता है, जब वे उपलब्ध होते हैं.

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार currentRouteSegmentTraffic में कब बदलाव किया गया था.

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

सिर्फ़ आउटपुट के लिए. वह पॉइंट जहां से currentRouteSegment खत्म होता है.

integer

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार remainingWaypoints कब बदला गया था (वेपॉइंट जोड़ा गया था, हटाया गया था या बदला गया था).

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पिछली बार remainingWaypoints.path_to_waypoint और remainingWaypoints.traffic_to_waypoint में कब बदलाव किया गया था. आपके क्लाइंट ऐप्लिकेशन को यह वैल्यू कैश मेमोरी में सेव करनी चाहिए और इसे GetTripRequest में पास करना चाहिए. इससे यह पक्का किया जा सकेगा कि remainingWaypoints के पाथ और ट्रैफ़िक, अपडेट होने पर ही दिखें.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

integer

इम्यूटेबल. यह इस यात्रा में यात्रियों की संख्या दिखाता है. इसमें ड्राइवर शामिल नहीं होता है. vehicles.search रिस्पॉन्स में लौटाए जाने के लिए, वाहन की मेमोरी में उपलब्ध जगह खाली होनी चाहिए.

object (VehicleLocation)

सिर्फ़ आउटपुट के लिए. रास्ते में मौजूद वाहन की आखिरी बार रिपोर्ट की गई जगह के बारे में बताता है.

boolean

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि वाहन के lastLocation को मौजूदाRoutesegment पर स्नैप किया जा सकता है या नहीं. lastLocation या currentRouteSegment मौजूद न होने पर, यह वैल्यू 'गलत' होती है. इसकी गिनती Fleet Engine ने की है. क्लाइंट के किसी भी अपडेट को अनदेखा कर दिया जाएगा.

enum (TripView)

यात्रा वाले फ़ील्ड का सबसेट जो अपने-आप भर जाता है और यह कैसे समझा जाना चाहिए.

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

ज़रूरी है. असल जगह दिखाता है.

string (Timestamp format)

बताता है कि स्टॉप कब हुआ था.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

सिर्फ़ इनपुट. समर्थन नहीं होना या रुकना. टाइमस्टैंप फ़ील्ड का इस्तेमाल करें.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".