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

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

string

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

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

string (Timestamp format)

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

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

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

string (Timestamp format)

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

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

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