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