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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
intermediateDestinations[]

object (TerminalLocation)

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
remainingWaypoints[]

object (TripWaypoint)

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

object (TripWaypoint)

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

object (LatLng)

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

string

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

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

string (Timestamp format)

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

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

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

object (ConsumableTrafficPolyline)

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

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

string (Timestamp format)

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

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

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

object (TripWaypoint)

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

integer

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

string (Timestamp format)

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

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

string (Duration format)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
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 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड रिज़ॉल्यूशन और नौ दशमलव अंकों के साथ. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
stopTime
(deprecated)

string (Timestamp format)

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

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

TripView

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

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

तरीके

create

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

get

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

update

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