REST Resource: providers.trips

संसाधन: यात्रा

यात्रा का मेटाडेटा.

JSON के काेड में दिखाना 
{
  "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)
}
फ़ील्ड
name

string

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

string

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

enum (TripStatus)

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

enum (TripType)

यात्रा का टाइप.
pickupPoint

object (TerminalLocation)

वह जगह जहां से ग्राहक ने पिक अप करने के लिए कहा है.
actualPickupPoint

object (StopLocation)

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

object (StopLocation)

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

string (Timestamp format)

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

आरएफ़सी 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".
intermediateDestinations[]

object (TerminalLocation)

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

string (Timestamp format)

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

आरएफ़सी 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".
intermediateDestinationIndex

integer

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

object (StopLocation)

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

object (StopLocation)

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

object (TerminalLocation)

वह जगह जहां ग्राहक ने बताया है कि उन्हें छोड़ा जाएगा.
actualDropoffPoint

object (StopLocation)

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

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. यात्री को मंज़िल पर छोड़ने का अनुमानित समय या उसे छोड़ने का असल समय.

आरएफ़सी 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".
remainingWaypoints[]

object (TripWaypoint)

सिर्फ़ आउटपुट के लिए. मौजूदा जगह से ड्रॉपऑफ़ पॉइंट तक का पूरा पाथ. इस पाथ में, अन्य यात्राओं के वे रास्ते शामिल हो सकते हैं.
vehicleWaypoints[]

object (TripWaypoint)

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

object (LatLng)

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

string

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

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

string (Timestamp format)

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.

आरएफ़सी 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".
currentRouteSegmentTraffic

object (ConsumableTrafficPolyline)

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.
currentRouteSegmentTrafficVersion

string (Timestamp format)

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

ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है.

आरएफ़सी 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".
currentRouteSegmentEndPoint

object (TripWaypoint)

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

integer

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

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट तक पहुंचने में लगने वाला अनुमानित समय (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".
remainingTimeToFirstWaypoint

string (Duration format)

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

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

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि 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".
remainingWaypointsRouteVersion

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि remainingWaypoints.path_to_waypoint और remainingWaypoints.traffic_to_waypoint में पिछली बार कब बदलाव किया गया था. आपके क्लाइंट ऐप्लिकेशन को इस वैल्यू को कैश मेमोरी में सेव करना चाहिए और उसे GetTripRequest में पास करना चाहिए. इससे यह पक्का किया जा सकेगा कि 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".
numberOfPassengers

integer

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

object (VehicleLocation)

सिर्फ़ आउटपुट के लिए. यह बताता है कि रास्ते पर वाहन की पिछली रिपोर्ट की गई जगह क्या है.
lastLocationSnappable

boolean

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

enum (TripView)

यात्रा के उन फ़ील्ड का सबसेट जिन्हें पॉप्युलेट किया जाता है और उनका विश्लेषण कैसे किया जाना चाहिए.

TripStatus

किसी यात्रा की स्थिति, जो उसकी प्रोग्रेस दिखाती है.

Enums
UNKNOWN_TRIP_STATUS डिफ़ॉल्ट, यात्रा की स्थिति के बारे में जानकारी न होने या पहचान न होने पर इस्तेमाल किया जाता है.
NEW हाल ही में बनाई गई यात्रा.
ENROUTE_TO_PICKUP ड्राइवर, पिकअप पॉइंट पर आ रहा है.
ARRIVED_AT_PICKUP ड्राइवर, पिकअप पॉइंट पर पहुंच गया है.
ARRIVED_AT_INTERMEDIATE_DESTINATION ड्राइवर, बीच के किसी पड़ाव पर पहुंच गया है और वह यात्री के आने का इंतज़ार कर रहा है.
ENROUTE_TO_INTERMEDIATE_DESTINATION ड्राइवर, किसी इंटरमीडिएट डेस्टिनेशन (ड्रॉपऑफ़ पॉइंट नहीं) के रास्ते में है.
ENROUTE_TO_DROPOFF ड्राइवर ने यात्री को पिकअप कर लिया है और वह अगले डेस्टिनेशन की ओर जा रहा है.
COMPLETE यात्री को उसके डेस्टिनेशन पर छोड़ दिया गया है और यात्रा पूरी हो गई है.
CANCELED ड्राइवर, सवारी करने वाले व्यक्ति या राईडशेयर की सेवा देने वाली कंपनी ने पिकअप से पहले ही यात्रा रद्द कर दी थी.

StopLocation

वह जगह जहां स्टॉप (पिकअप/ड्रॉपऑफ़) हुआ.

JSON के काेड में दिखाना 
{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}
फ़ील्ड
point

object (LatLng)

ज़रूरी है. असल जगह की जानकारी देता है.
timestamp

string (Timestamp format)

इससे पता चलता है कि बस कब रुकी.

आरएफ़सी 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".
stopTime
(deprecated)

string (Timestamp format)

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

आरएफ़सी 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".

TripView

trips.get रिस्पॉन्स में, ट्रिप फ़ील्ड के अलग-अलग सेट के लिए सिलेक्टर. ज़्यादा जानकारी के लिए, AIP-157 देखें. ऐसा हो सकता है कि ज़्यादा व्यू जोड़े जाएं.

Enums
TRIP_VIEW_UNSPECIFIED डिफ़ॉल्ट वैल्यू. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई डिफ़ॉल्ट रूप से SDK टूल व्यू पर सेट हो जाएगा. ग्राहकों को हमारा सुझाव है कि वे SDK के बजाय कोई दूसरा TripView चुनें, ताकि उन्हें बेहतर परफ़ॉर्मेंस और सहायता मिल सके.
SDK इसमें ऐसे फ़ील्ड शामिल होते हैं जिनका मतलब सार्वजनिक तौर पर उपलब्ध लाइब्रेरी का इस्तेमाल करके नहीं समझा जा सकता या जिनका इस्तेमाल नहीं किया जा सकता.
JOURNEY_SHARING_V1S यात्रा की जानकारी शेयर करने के उदाहरण के लिए, यात्रा के फ़ील्ड अपने-आप भर जाते हैं. यह व्यू, सर्वर-टू-सर्वर कम्यूनिकेशन के लिए है.

तरीके

create

 Fleet Engine में एक यात्रा बनाता है और नई यात्रा दिखाता है.

delete

 किसी एक ट्रिप को मिटाता है.

get

 किसी एक यात्रा के बारे में जानकारी पाना.
किसी खास वाहन की सभी यात्राएं देखें.

update

 यात्रा का डेटा अपडेट करता है.