यात्रा का डेटा वापस पाने पर, आपके बैकएंड को JSON पेलोड मिलते हैं. इनमें ड्राइवर की यात्रा की प्रोग्रेस की जानकारी होती है. यात्रा को मॉनिटर करने, अपने डिस्पैच सिस्टम को अपडेट करने, और यात्रा के मौजूदा स्टेटस को समझने के लिए, इन पेलोड को पार्स करें. इससे, यात्रा के दौरान या यात्रा खत्म होने पर, ड्राइवर के लिए अगला कदम तय करने में मदद मिलती है.
डेटा पेलोड को पढ़ना
जब ड्राइवर नेविगेट करना शुरू करता है, तब Google Maps या Waze, Navigation Connect के सर्वर को यात्रा के डेटा पेलोड भेजता है. यह डेटा, रास्ते के दौरान समय-समय पर (डिफ़ॉल्ट रूप से हर 60 सेकंड में) और ड्राइवर के मंज़िल पर पहुंचने पर भेजा जाता है. हर JSON मैसेज में यात्रा का ज़रूरी डेटा होता है. इसमें ड्राइवर के रोड-स्नैप किए गए निर्देशांक, तय की गई दूरी, और पहुंचने का अनुमानित समय (ईटीए) शामिल होता है. ये अपडेट, ड्राइवर के ऐक्टिव और रीयल-टाइम रूट को दिखाते हैं. इसलिए, हो सकता है कि ये आपके बैकएंड से पहले से कैलकुलेट किए गए रूट से अलग हों. ज़्यादा जानकारी के लिए, अक्सर पूछे जाने वाले सवाल देखें.
यहां दिए गए कोड सैंपल में, यात्रा के डेटा का पेलोड दिखाया गया है. यह पेलोड तब दिखता है, जब कोई ड्राइवर किंग क्रॉस से सेंट्रल सेंट जाइल्स तक की यात्रा के लिए नेविगेशन शुरू करता है.
{
"name": "projects/123456/trips/221B9CD6-4146-4CBF-9556-853817654938",
"state": "ENROUTE",
"execution": {
"origin": {
"point": {
"latitude": 51.5333329,
"longitude": -0.1265845
}
},
"destination": {
"point": {
"latitude": 51.515598,
"longitude": -0.1277623
}
},
"location": {
"point": {
"latitude": 51.5333329,
"longitude": -0.1265845
},
"sourceTime": "2025-05-30T12:37:26Z",
"serverTime": "2025-05-30T12:37:26.221069Z"
},
"traveledDuration": "0s",
"remainingDuration": "990s",
"traveledDistanceMeters": 0,
"remainingDistanceMeters": 2879,
"stopAddedInRoute": false
}
}
चालू यात्राओं की स्थितियों पर नज़र रखना
यह पुष्टि करने के लिए कि माइग्रेशन शुरू हो गया है और उसकी प्रोग्रेस को मॉनिटर करने के लिए, हर पेलोड में state फ़ील्ड की जांच करें.
| स्थिति | ब्यौरा |
|---|---|
NEW |
यात्रा की जानकारी जोड़ दी गई है, लेकिन ड्राइवर ने अभी तक नेविगेट करना शुरू नहीं किया है. |
ENROUTE |
ड्राइवर, मंज़िल की ओर जा रहा है. इस स्थिति का इस्तेमाल करके, पुष्टि करें कि यात्रा की पुष्टि हो गई है और वह शुरू हो गई है. |
जोड़े गए स्टॉप मैनेज करना
ड्राइवर, नेविगेशन के दौरान अपने रास्ते में स्टॉप जोड़ सकते हैं. अगर ऐसा होता है, तो Navigation Connect, JSON डेटा पेलोड में execution.stopAddedInRoute फ़ील्ड को true पर सेट कर देता है. Navigation Connect API, ड्राइवर को उसकी मूल मंज़िल तक ट्रैक करता रहता है. जोड़े गए स्टॉप को शामिल करने के लिए, पहुंचने का अनुमानित समय (ईटीए), दूरी, और अवधि जैसी मेट्रिक बढ़ जाती हैं.
स्टॉप जोड़ने का तरीका, नेविगेशन ऐप्लिकेशन पर निर्भर करता है और उसकी स्टैंडर्ड सुविधाओं से मेल खाता है:
- Google Maps: ड्राइवर अपने रास्ते में एक से ज़्यादा स्टॉप जोड़ सकते हैं.
- Waze: ड्राइवर सिर्फ़ एक स्टॉप जोड़ सकते हैं. अगर कोई ड्राइवर एक और स्टॉप जोड़ने की कोशिश करता है, तो Waze उसे मौजूदा रास्ते में स्टॉप जोड़ने के बजाय, नया नेविगेशन सेशन शुरू करने के लिए कहता है.
इस सुविधा का इस्तेमाल करने के लिए, आपको बैकएंड इनपुट में बदलाव करने की ज़रूरत नहीं है.
पुष्टि करने और शुरू करने से जुड़ी समस्याएं हल करना
अगर आपको ENROUTE स्टेटस नहीं मिलता है, तो हो सकता है कि पुष्टि करने में कोई गड़बड़ी हुई हो. इसकी सामान्य वजहों में, एपीआई पैरामीटर की गलत स्पेलिंग या यात्रा के लिए इस्तेमाल किए जाने वाले टोकन की समयसीमा खत्म होना शामिल है. अपने शुरुआती CreateTrip रिस्पॉन्स में, टोकन की समयसीमा खत्म होने का समय देखें.
अगर स्टेटस NEW से ENROUTE में नहीं बदलता है, तो हो सकता है कि ड्राइवर का डिवाइस, पुष्टि करने की प्रोसेस को रोक रहा हो. Navigation Connect, इन मामलों में गड़बड़ी के मैसेज नहीं भेजता. इन बातों की पुष्टि करें:
- ड्राइवर के पास Waze का 5.15.5 या इसके बाद का वर्शन या Google Maps का 26.14 या इसके बाद का वर्शन इंस्टॉल हो.
- ड्राइवर, Android Auto या Apple CarPlay का इस्तेमाल नहीं कर रहा है.
- ड्राइवर के पास इंटरनेट कनेक्शन हो.
रास्ते का बाकी डेटा मैनेज करना
अगर आपने यात्रा तैयार करते समय बचे हुए रास्ते की जानकारी देने की सुविधा चालू की है, तो आपके बैकएंड को बचे हुए रास्ते की पॉलीलाइन और रीयल-टाइम ट्रैफ़िक की जानकारी मिलती है. यह जानकारी, ड्राइवर की मौजूदा जगह से लेकर उसकी मंज़िल तक के लिए मिलती है. ड्राइवर के पास Android पर Waze का 5.20.0.2 या इसके बाद का वर्शन, iOS पर 5.20.0.1 या इसके बाद का वर्शन या Android पर Google Maps का 26.27 या इसके बाद का वर्शन होना चाहिए.
इस डेटा को अपने ऐप्लिकेशन में शामिल और प्रोसेस करके, कई सुविधाओं को बेहतर बनाया जा सकता है. जैसे:
- लाइव ट्रैकिंग मैप की सुविधा देना: ग्राहक को दिखने वाले वेब या मोबाइल मैप पर, बचे हुए रास्ते की पॉलीलाइन रेंडर करें. इससे ग्राहक को ड्राइवर की यात्रा की जानकारी मिलती है.
- ईटीए को ज़्यादा सटीक बनाएं: सड़क पर स्नैप की गई पॉलीलाइन और ट्रैफ़िक इंटरवल की स्पीड को जोड़ें. इससे, इंटरनल लॉजिस्टिक्स या डिलीवरी के पहुंचने के अनुमान को बेहतर बनाया जा सकता है.
- रूटिंग के अनुपालन का विश्लेषण करना: बाकी बचे रूट की ज्यामिति की तुलना, डिस्पैच के लिए तय किए गए रूट से करें. इससे यह आकलन किया जा सकता है कि ड्राइवर ने तय किए गए रूट का पालन किया है या नहीं. रीयल-टाइम और पहले से तय किए गए रूट में अंतर होने की वजह जानने के लिए, अक्सर पूछे जाने वाले सवाल देखें.
नेविगेशन कनेक्ट, execution.remainingRoute फ़ील्ड में बचे हुए रास्ते की जानकारी दिखाता है. भले ही, आपने GetTrip अनुरोध भेजा हो या Google Cloud Pub/Sub का इस्तेमाल करके, इवेंट के हिसाब से अपडेट पाने का विकल्प चुना हो. हालांकि, पेलोड इस डेटा को किस तरह फ़ॉर्मैट और स्ट्रक्चर करता है, यह डेटा वापस पाने के लिए इस्तेमाल किए गए तरीके पर निर्भर करता है.
GetTrip तरीका
GetTrip तरीके को कॉल करने पर, पॉलीलाइन के लिए रिस्पॉन्स का फ़ॉर्मैट, आपके अनुरोध में बताए गए routePolylineFormat पैरामीटर पर निर्भर करता है. ज़्यादा जानकारी के लिए, पॉलीलाइन के फ़ॉर्मैट को पसंद के मुताबिक बनाना देखें.
सभी पॉलीलाइन फ़ॉर्मैट के लिए, Navigation Connect ट्रैफ़िक को
execution.remainingRoute.trafficInformation
फ़ील्ड में
SpeedReadingInterval
ऑब्जेक्ट की एक अलग सूची के तौर पर दिखाता है. ये ऑब्जेक्ट, नीचे दी गई वैल्यू का इस्तेमाल करके, ट्रैफ़िक की कैटगरी को पॉलीलाइन इंडेक्स पर मैप करते हैं:
startPolylinePointIndex: पॉलीलाइन पर ट्रैफ़िक इंटरवल का शुरुआती इंडेक्स.endPolylinePointIndex: ट्रैफ़िक इंटरवल का आखिरी इंडेक्स.speed: इस सेगमेंट के लिए ट्रैफ़िक की कैटगरी:NORMAL,SLOWयाTRAFFIC_JAM.
Google Cloud Pub/Sub से जुड़े अपडेट
Pub/Sub की मदद से यात्रा का डेटा वापस पाने पर, अपडेट हमेशा यूनिफ़ाइड GeoJSON FeatureCollection में बचे हुए रास्ते का डेटा दिखाते हैं. यह डेटा, execution.remainingRoute फ़ील्ड में दिखता है.
इस फ़ॉर्मैट में, पॉलीलाइन ज्यामिति को सीधे ट्रैफ़िक की स्पीड के साथ जोड़ा जाता है. इससे इंडेक्स को मैन्युअल तरीके से मैप करने की ज़रूरत नहीं पड़ती.
Pub/Sub पेलोड का उदाहरण देखें
यहां दिए गए कोड सैंपल में, Pub/Sub मैसेज के updatedTrip ऑब्जेक्ट में मौजूद execution.remainingRoute फ़ील्ड में दिखाया गया GeoJSON स्ट्रक्चर दिखाया गया है:
{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [-122.3934, 37.7955], [-122.4010, 37.7980] ] }, "properties": { "speed": "SLOW" } }, { "type": "Feature", "geometry": { "type": "LineString", "coordinates": [ [-122.4010, 37.7980], [-122.4058, 37.8025], [-122.4187, 37.8021] ] }, "properties": { "speed": "NORMAL" } } ] }
पेलोड का साइज़ ऑप्टिमाइज़ करना
कोऑर्डिनेट कलेक्शन बड़े होते हैं. इसलिए, Pub/Sub मैसेज में बचे हुए रास्ते का डेटा शामिल करने से, पेलोड का साइज़ काफ़ी बढ़ सकता है. यह साइज़, हर मैसेज के लिए 13 से 14 केबी तक हो सकता है. अगर आपको बार-बार अपडेट मिलते हैं, तो इससे बैकएंड प्रोसेसिंग लोड और इस्तेमाल की लागत बढ़ सकती है.
अपनी स्ट्रीम को ऑप्टिमाइज़ करने के लिए, यात्रा तैयार करते समय अपने TripConfig ऑब्जेक्ट में pubsubFieldMask पैरामीटर का इस्तेमाल करें. इससे, ज़्यादा डेटा वाले फ़ील्ड को बाहर रखा जा सकता है. ज़्यादा जानकारी के लिए, ज़रूरी नहीं होने वाले कॉन्फ़िगरेशन देखें.
तय रास्ते में हुए बदलावों को मैनेज करना (सिर्फ़ Waze के लिए)
ड्राइवर के पास Waze का 5.22 या इसके बाद का वर्शन होना चाहिए.
अगर आपने यात्रा की जानकारी तैयार करते समय, तय रास्ते में बदलाव की रिपोर्टिंग की सुविधा चालू की है, तो ड्राइवर के तय रास्ते से भटकने पर, एपीआई तय रास्ते में बदलाव का मेटाडेटा दिखाता है. इस डेटा को ऐक्सेस करने के लिए, ये तरीके अपनाए जा सकते हैं:
- मांग पर:
GetTripवाले तरीके को कॉल करें. सर्वर, आखिरी बार पता चली विचलन की स्थिति को बनाए रखता है. - रीयल-टाइम: Google Cloud Pub/Sub की सदस्यता लें. यह सेवा, मौजूदा
updated_tripइवेंट का इस्तेमाल करके, तय किए गए पाथ से भटकने के अपडेट पब्लिश करती है. यह अपडेट, पाथ से भटकने का पता चलने के पांच सेकंड के अंदर पब्लिश किया जाता है.
डेविएशन पेलोड पढ़ें
last_route_deviation ऑब्जेक्ट, इवेंट का विश्लेषण करने में आपकी मदद करने के लिए, यह मेटाडेटा उपलब्ध कराता है.
| फ़ील्ड | टाइप | ब्यौरा |
|---|---|---|
location |
LatLng |
अक्षांश और देशांतर के निर्देशांक, जहां क्लाइंट डिवाइस ने अंतर रिकॉर्ड किया. |
source |
TriggerSource |
डेविएशन की वजह. इसका इस्तेमाल करके यह पता लगाएं कि ड्राइवर ने कोई अनचाही कार्रवाई की या सिस्टम के निर्देशों का पालन किया:
|
client_timestamp |
Timestamp |
क्लाइंट डिवाइस को डेविएशन का पता चलने का समय. |
server_timestamp |
Timestamp |
वह समय जब सर्वर ने डेविएशन अपडेट को प्रोसेस किया. |
यात्रा खत्म होने की स्थितियों को मैनेज करना
जब कोई ड्राइवर मंज़िल पर पहुंचता है या नेविगेट करना बंद कर देता है, तो पेलोड इनमें से कोई एक एंड स्टेट दिखाता है. इन स्टेटस का इस्तेमाल करके, अपने ऐप्लिकेशन में सही अगला चरण ट्रिगर करें.
| स्थिति | ब्यौरा | सुझाई गई कार्रवाई |
|---|---|---|
ARRIVED |
ड्राइवर मंज़िल पर पहुंच गया है. | remainingDistanceMeters देखें. अगर ड्राइवर ने आस-पास कहीं गाड़ी पार्क की है, लेकिन सटीक जगह पर नहीं, तो अपने ऐप्लिकेशन में पैदल रास्ते की जानकारी दें. |
SUSPENDED |
ड्राइवर ने मंज़िल पर पहुंचने से पहले ही, रास्ते के दिशा-निर्देश की सुविधा को मैन्युअल तरीके से बंद कर दिया. अगर ड्राइवर किसी सेशन को समय से पहले बंद कर देते हैं, तो Google Maps या Waze उन्हें आपके ऐप्लिकेशन पर अपने-आप वापस नहीं भेजता. इसलिए, ड्राइवर को वापस जाने के लिए, बटन पर मैन्युअल तरीके से टैप करना होगा. |
ड्राइवर को उनकी मंज़िल तक पहुंचने में मदद करने के लिए, मंज़िल की तुलना execution.location से करें. अगर दूरी बची है, तो यात्रा फिर से शुरू करने या पैदल चलने के मोड पर स्विच करने के लिए, कोई बटन या लिंक दें. |
FAILED |
किसी तकनीकी गड़बड़ी की वजह से कनेक्शन टूट गया. ऐसा तब होता है, जब ऐप्लिकेशन रास्ते का हिसाब नहीं लगा पाता या सुरक्षा से जुड़ी चेतावनी दिखती है. ऐसा हो सकता है कि ड्राइवर अब भी नेविगेट कर रहा हो, लेकिन आपको अपडेट नहीं मिलेंगे. | अपने ऐप्लिकेशन में, मैन्युअल तरीके से स्टेटस ट्रैक करने की सुविधा का इस्तेमाल करें. |
CLIENT_ERROR |
यह स्टेटस इनमें से किसी एक वजह से दिखता है:
|
अपने ऐप्लिकेशन में, मैन्युअल तरीके से स्टेटस ट्रैक करने की सुविधा का इस्तेमाल करें. |