संसाधन: यात्रा
यात्रा का मेटाडेटा.
JSON के काेड में दिखाना |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
फ़ील्ड | |
---|---|
name |
सिर्फ़ आउटपुट के लिए. "providers/{provider}/trips/{trip}" फ़ॉर्मैट में |
vehicleId |
इस यात्रा के लिए जा रहे वाहन का आईडी. |
tripStatus |
यात्रा की मौजूदा स्थिति. |
tripType |
यात्रा किस तरह की है. |
pickupPoint |
वह जगह जहां ग्राहक से पता चलता है कि उसे पिक अप किया जाएगा. |
actualPickupPoint |
सिर्फ़ इनपुट. उस जगह की असल जानकारी जहां खरीदार को पिक अप किया गया था और जहां से उसे पिक अप किया गया था. इस फ़ील्ड पर, डिलीवरी की सेवा देने वाली कंपनी को पिकअप की असल जानकारी के बारे में सुझाव या राय दी जा सकती है. |
actualPickupArrivalPoint |
सिर्फ़ इनपुट. पिकअप पॉइंट पर ड्राइवर के पहुंचने का असल समय और जगह की जानकारी. इस फ़ील्ड की मदद से सेवा देने वाली कंपनी, पिकअप पॉइंट पर पहुंचने के समय की असल जानकारी के बारे में सुझाव दे सकती है. |
pickupTime |
सिर्फ़ आउटपुट के लिए. या तो अनुमानित समय, जब राइडर को पिक अप किया जाएगा या वह असल समय जब उसे पिक अप किया जाएगा. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
intermediateDestinations[] |
यात्रा के अनुरोध के क्रम में बीच के स्टॉप (पिकअप और ड्रॉप-ऑफ़ के अलावा). शुरुआत में, यह सुविधा शेयर की गई यात्राओं के लिए उपलब्ध नहीं होगी. |
intermediateDestinationsVersion |
यह बताता है कि पिछली बार आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
intermediateDestinationIndex |
|
actualIntermediateDestinationArrivalPoints[] |
सिर्फ़ इनपुट. किसी इंटरमीडिएट डेस्टिनेशन पर ड्राइवर के आने का असल समय और जगह. इस फ़ील्ड की मदद से, सेवा देने वाली कंपनी को इंटरमीडिएट डेस्टिनेशन पर पहुंचने के बारे में सुझाव दिया जा सकता है. |
actualIntermediateDestinations[] |
सिर्फ़ इनपुट. किसी इंटरमीडिएट डेस्टिनेशन से, खरीदार को पिक अप किए जाने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वे इंटरमीडिएट डेस्टिनेशन पर पिकअप की असल जानकारी के बारे में सुझाव दे सकें. |
dropoffPoint |
वह जगह जहां ग्राहक संकेत देता है कि उसे वहां से हटा दिया जाएगा. |
actualDropoffPoint |
सिर्फ़ इनपुट. उस समय और जगह की जानकारी, जब ग्राहक को सेवा से हटाया गया था. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह ड्रॉप-ऑफ़ की असल जानकारी के बारे में सुझाव दे सके. |
dropoffTime |
सिर्फ़ आउटपुट के लिए. वह अनुमानित समय जब राइडर को आखिरी मंज़िल पर उतारा जाएगा या उसके रवाना होने का असल समय. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
remainingWaypoints[] |
सिर्फ़ आउटपुट के लिए. मौजूदा जगह से ड्रॉप-ऑफ़ पॉइंट तक का पूरा रास्ता (इसमें शामिल है). इस पाथ में दूसरी यात्राओं के वेपॉइंट शामिल हो सकते हैं. |
vehicleWaypoints[] |
इस फ़ील्ड में यात्रा के लिए वेपॉइंट को मैन्युअल तरीके से क्रम में लगाया जा सकता है. इसमें असाइन किए गए वाहन के लिए बाकी सभी वेपॉइंट मौजूद होते हैं. साथ ही, इस यात्रा के लिए पिक अप और ड्रॉप-ऑफ़ वेपॉइंट भी होते हैं. अगर यात्रा किसी वाहन को असाइन नहीं की गई है, तो फ़्लीट इंजन इस फ़ील्ड को अनदेखा कर देता है. निजता की वजहों से, इस फ़ील्ड को सर्वर से सिर्फ़ |
route[] |
सिर्फ़ आउटपुट के लिए. बचे हुए वेपॉइंट में पहली एंट्री के लिए, इस यात्रा का अनुमानित रास्ता. ध्यान दें कि पहला वेपॉइंट किसी दूसरी यात्रा से जुड़ा हो सकता है. |
currentRouteSegment |
सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट के लिए कोड में बदला गया पाथ. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है. डिकोड करने की सुविधा अभी तक उपलब्ध नहीं है. |
currentRouteSegmentVersion |
सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार रास्ते में कब बदलाव किया गया था. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
currentRouteSegmentTraffic |
सिर्फ़ आउटपुट के लिए. यह ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है. |
currentRouteSegmentTrafficVersion |
सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ ड्राइवर SDK टूल और उपभोक्ता SDK टूल के लिए किया जा सकता है. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
currentRouteSegmentEndPoint |
सिर्फ़ आउटपुट के लिए. वह पॉइंट जहां से |
remainingDistanceMeters |
सिर्फ़ आउटपुट के लिए. |
etaToFirstWaypoint |
सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट तक पहुंचने का ETA ( आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
remainingTimeToFirstWaypoint |
सिर्फ़ आउटपुट के लिए. यात्रा का डेटा वापस मिलने से लेकर सेकंड में कुल नौ दशमलव अंक, जो ' |
remainingWaypointsVersion |
सिर्फ़ आउटपुट के लिए. यह बताता है कि पिछली बार आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
remainingWaypointsRouteVersion |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि पिछली बार आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
numberOfPassengers |
इम्यूटेबल. यह इस यात्रा में यात्रियों की संख्या दिखाता है. इसमें ड्राइवर शामिल नहीं होता है. |
lastLocation |
सिर्फ़ आउटपुट के लिए. रास्ते में मौजूद वाहन की आखिरी बार रिपोर्ट की गई जगह के बारे में बताता है. |
lastLocationSnappable |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि वाहन के |
view |
यात्रा वाले फ़ील्ड का सबसेट जो अपने-आप भर जाता है और यह कैसे समझा जाना चाहिए. |
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 ( |
फ़ील्ड | |
---|---|
point |
ज़रूरी है. असल जगह दिखाता है. |
timestamp |
बताता है कि स्टॉप कब हुआ था. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
stopTime |
सिर्फ़ इनपुट. समर्थन नहीं होना या रुकना. टाइमस्टैंप फ़ील्ड का इस्तेमाल करें. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
TripView
trips.get
रिस्पॉन्स में यात्रा फ़ील्ड के अलग-अलग सेट के लिए सिलेक्टर. ज़्यादा जानकारी के लिए, AIP-157 पर जाएं. इसमें और व्यू जोड़े जा सकते हैं.
Enums | |
---|---|
TRIP_VIEW_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू. पुराने सिस्टम के साथ काम करने के लिए, एपीआई डिफ़ॉल्ट रूप से SDK व्यू का इस्तेमाल करेगा. ऐप्लिकेशन को क्रैश या फ़्रीज़ होने से बचाने के लिए, ग्राहकों को SDK के बजाय कोई दूसरा TripView चुनने की सलाह दी जाती है. |
SDK |
इसमें ऐसे फ़ील्ड शामिल होते हैं जिन्हें सार्वजनिक तौर पर उपलब्ध लाइब्रेरी की मदद से समझा जा सकता है या जिनका इस्तेमाल किया जा सकता है. |
JOURNEY_SHARING_V1S |
यात्रा शेयर करने की सुविधा के इस्तेमाल के उदाहरण के लिए, यात्रा के फ़ील्ड भरे जाते हैं. यह व्यू, सर्वर-टू-सर्वर कम्यूनिकेशन के लिए है. |
तरीके |
|
---|---|
|
फ़्लीट इंजन में ट्रिप बनाता है और नई यात्रा दिखाता है. |
|
किसी एक यात्रा के बारे में जानकारी पाना. |
|
किसी वाहन की सभी यात्राएं देखें. |
|
यात्रा का डेटा अपडेट करता है. |