संसाधन: यात्रा
यात्रा का मेटाडेटा.
JSON के काेड में दिखाना |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
फ़ील्ड | |
---|---|
name |
सिर्फ़ आउटपुट के लिए. "providers/{provider}/trips/{trip}" फ़ॉर्मैट में |
vehicle |
इस यात्रा के लिए इस्तेमाल किए जा रहे वाहन का आईडी. |
trip |
यात्रा की मौजूदा स्थिति. |
trip |
यात्रा का टाइप. |
pickup |
वह जगह जहां से ग्राहक ने पिक अप करने का अनुरोध किया है. |
actual |
सिर्फ़ इनपुट के लिए. ग्राहक को पिक अप करने की जगह और समय की असल जानकारी. यह फ़ील्ड, पिकअप की असल जानकारी के बारे में सुझाव देने के लिए है. |
actual |
सिर्फ़ इनपुट के लिए. पिकअप पॉइंट पर ड्राइवर के पहुंचने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है. इसमें, पिकअप पॉइंट पर पहुंचने की असल जानकारी दी जाती है. |
pickup |
सिर्फ़ आउटपुट के लिए. आने वाले समय में, यात्रियों को पिकअप करने का अनुमानित समय या उन्हें पिकअप करने का असल समय. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
intermediate |
यात्रा के अनुरोध के लिए, पिकअप और ड्रॉपऑफ़ के अलावा, बीच में किए जाने वाले स्टॉप का क्रम. शुरुआत में, यह सुविधा शेयर की गई यात्राओं के लिए उपलब्ध नहीं होगी. |
intermediate |
इससे पता चलता है कि आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
intermediate |
जब |
actual |
सिर्फ़ इनपुट के लिए. किसी बीच की मंज़िल पर ड्राइवर के पहुंचने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह बीच के स्टॉपेज पर पहुंचने की असल जानकारी दे सके. |
actual |
सिर्फ़ इनपुट के लिए. उस जगह का असल समय और जगह जहां से ग्राहक को पिक अप किया गया था. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह बीच के स्टॉप पर पिकअप की असल जानकारी दे सके. |
dropoff |
वह जगह जहां ग्राहक ने बताया है कि उन्हें छोड़ा जाएगा. |
actual |
सिर्फ़ इनपुट के लिए. ग्राहक को छोड़ने का असल समय और जगह. यह फ़ील्ड, सेवा देने वाली कंपनी के लिए है, ताकि वह ड्रॉपऑफ़ की असल जानकारी के बारे में सुझाव, राय या शिकायत दे सके. |
dropoff |
सिर्फ़ आउटपुट के लिए. यात्री को उसके डेस्टिनेशन पर छोड़ने का अनुमानित समय या असल समय. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
remaining |
सिर्फ़ आउटपुट के लिए. मौजूदा जगह से ड्रॉपऑफ़ पॉइंट तक का पूरा पाथ. इस पाथ में, अन्य यात्राओं के वे रास्ते शामिल हो सकते हैं. |
vehicle |
इस फ़ील्ड की मदद से, यात्रा के लिए वे रास्ते मैन्युअल तरीके से क्रम में लगाए जा सकते हैं. इसमें, असाइन किए गए वाहन के लिए बचे हुए सभी वेपॉइंट के साथ-साथ, इस यात्रा के लिए पिकअप और ड्रॉप-ऑफ़ वेपॉइंट भी शामिल होते हैं. अगर यात्रा को किसी वाहन को असाइन नहीं किया गया है, तो Fleet Engine इस फ़ील्ड को अनदेखा कर देता है. निजता की वजहों से, यह फ़ील्ड सिर्फ़ |
route[] |
सिर्फ़ आउटपुट के लिए. remainingWaypoints में मौजूद पहली एंट्री तक, इस यात्रा का अनुमानित रास्ता. ध्यान दें कि पहला वेपॉइंट किसी दूसरी यात्रा का हो सकता है. |
current |
सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट का कोड किया गया पाथ. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है. फ़िलहाल, डिकोड करने की सुविधा उपलब्ध नहीं है. |
current |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि रास्ते में पिछली बार कब बदलाव किया गया था. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
current |
सिर्फ़ आउटपुट के लिए. ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है. |
current |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि ध्यान दें: इस फ़ील्ड का इस्तेमाल सिर्फ़ Driver SDK और Consumer SDK के लिए किया जाता है. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
current |
सिर्फ़ आउटपुट के लिए. वह वेपॉइंट जहां |
remaining |
सिर्फ़ आउटपुट के लिए. |
eta |
सिर्फ़ आउटपुट के लिए. अगले वेपॉइंट तक पहुंचने में लगने वाला अनुमानित समय ( आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
remaining |
सिर्फ़ आउटपुट के लिए. यात्रा का डेटा वापस मिलने से लेकर सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि ' |
remaining |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
remaining |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
number |
इनमें बदलाव नहीं किया जा सकता. इस यात्रा में शामिल यात्रियों की संख्या दिखाता है. इसमें ड्राइवर शामिल नहीं होता. |
last |
सिर्फ़ आउटपुट के लिए. यह बताता है कि रास्ते पर वाहन की पिछली रिपोर्ट की गई जगह क्या है. |
last |
सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि वाहन के |
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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
stopTime |
सिर्फ़ इनपुट के लिए. समर्थन नहीं होना या रुकना. टाइमस्टैंप फ़ील्ड का इस्तेमाल करें. आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: |
TripView
trips.get
रिस्पॉन्स में, ट्रिप फ़ील्ड के अलग-अलग सेट के लिए सिलेक्टर. ज़्यादा जानकारी के लिए, AIP-157 देखें. ऐसा हो सकता है कि ज़्यादा व्यू जोड़े जाएं.
Enums | |
---|---|
TRIP_VIEW_UNSPECIFIED |
डिफ़ॉल्ट वैल्यू. पुराने सिस्टम के साथ काम करने की सुविधा के लिए, एपीआई डिफ़ॉल्ट रूप से SDK टूल व्यू पर सेट हो जाएगा. ग्राहकों को हमारा सुझाव है कि वे SDK के बजाय कोई दूसरा TripView चुनें, ताकि उन्हें बेहतर परफ़ॉर्मेंस और सहायता मिल सके. |
SDK |
इसमें ऐसे फ़ील्ड शामिल होते हैं जिनका मतलब सार्वजनिक तौर पर उपलब्ध लाइब्रेरी का इस्तेमाल करके नहीं समझा जा सकता या जिनका इस्तेमाल नहीं किया जा सकता. |
JOURNEY_SHARING_V1S |
यात्रा की जानकारी शेयर करने के उदाहरण के लिए, यात्रा के फ़ील्ड अपने-आप भर जाते हैं. यह व्यू, सर्वर-टू-सर्वर कम्यूनिकेशन के लिए है. |
तरीके |
|
---|---|
|
यह फ़ंक्शन, फ़्लीट इंजन में एक यात्रा बनाता है और नई यात्रा दिखाता है. |
|
किसी एक यात्रा के बारे में जानकारी पाना. |
|
किसी खास वाहन की सभी यात्राएं देखें. |
|
यात्रा का डेटा अपडेट करता है. |