यू-टर्न से बचने की सुविधा, रास्ते को ऑप्टिमाइज़ करने वाली सुविधा है. यह सुविधा, वाहनों को किसी जगह पर पिकअप या डिलीवरी के लिए जाने के दौरान यू-टर्न लेने से रोकती है. यू-टर्न से बचने की सेटिंग सेट करके, यह तय किया जाता है कि वाहन किसी जगह पर पहुंचने और वहां से निकलने के दौरान, एक ही दिशा में होना चाहिए.
यू-टर्न से बचने की सुविधा इस तरह काम करती है:
- आपने किसी खास विज़िट के लिए, यू-टर्न से बचने की प्रॉपर्टी सेट की हो.
- एपीआई, दोतरफ़ा सड़कों पर यात्रा की दोनों दिशाओं पर विचार करता है और सबसे सही रास्ता चुनता है.
- यह एपीआई ऐसा रास्ता जनरेट करता है जहां वाहन, विज़िट की जगह पर यू-टर्न लिए बिना पहुंचता है और वहां से निकल जाता है. इस जगह पर पहुंचने के लिए, ड्राइवर को सड़क पार करनी पड़ सकती है.
यह प्रॉपर्टी उन स्थितियों के लिए सही है जहां वाहन के साइज़, ट्रैफ़िक के साइन या सामान्य ट्रैफ़िक के हाल की वजह से, यू-टर्न लेना मुश्किल या नामुमकिन हो.
प्रॉपर्टी
यू-टर्न से बचने की सुविधा वाली प्रॉपर्टी, VisitRequest ऑब्जेक्ट में तय की जाती है.
इस ऑब्जेक्ट का इस्तेमाल, शिपमेंट के pickups और deliveries कलेक्शन में किया जाता है.
| प्रॉपर्टी | टाइप | ब्यौरा |
|---|---|---|
avoidUTurns |
बूलियन | इस पैरामीटर को true पर सेट करने से, एपीआई वाहन को इस जगह पर यू-टर्न लेने से रोकता है. वाहन एक ही दिशा में आएगा और जाएगा. |
उदाहरण
इस सेक्शन में, दो तरह के उदाहरण दिए गए हैं:
- यू-टर्न से बचने के तरीके के बारे में बताने वाले कोड सैंपल.
- अनुरोध का एक उदाहरण जिसमें यह सुविधा शामिल है.
कोड सैंपल
यहां दिए गए उदाहरण में, पिकअप और डिलीवरी के लिए avoidUTurns का स्ट्रक्चर दिखाया गया है:
"pickups":[ { "arrivalLocation": { "latitude": 37.42506261000996, "longitude": -122.09535511930135 }, "avoidUTurns": true } ], "deliveries":[ { "arrivalLocation": { "latitude": 37.42421503206021, "longitude": -122.09526063135228 }, "avoidUTurns": true } ]
अनुरोध का उदाहरण
यहां दिए गए उदाहरण में, optimizeTours का एक बुनियादी अनुरोध दिखाया गया है. इसमें यू-टर्न से बचने की सुविधा शामिल है. इस अनुरोध में ये एलिमेंट शामिल होते हैं:
modelऑब्जेक्ट में पिकअप और डिलीवरी की जानकारी वाला शिपमेंट.avoidUTurnsप्रॉपर्टी को पिकअप और डिलीवरी, दोनों जगहों के लिएtrueपर सेट किया गया है, ताकि वाहन उन स्टॉप पर दिशा न बदले.
{ "model": { "shipments":[ { "pickups":[ { "arrivalLocation": { "latitude": 37.42506261000996, "longitude": -122.09535511930135 }, "avoidUTurns": true } ], "deliveries":[ { "arrivalLocation": { "latitude": 37.42421503206021, "longitude": -122.09526063135228 }, "avoidUTurns": true } ] } ], "vehicles":[ { "travelMode": "DRIVING", "costPerKilometer": 1.0 } ] } }
sideOfRoad का इस्तेमाल करके यू-टर्न से बचें
sideOfRoad एक अलग सुविधा है. हालांकि, यह यू-टर्न से बचने की सुविधा से काफ़ी मिलती-जुलती है. ऐसा इसलिए, क्योंकि यह वाहन को सड़क के उस किनारे पर ले जाती है जो मंज़िल के सबसे करीब होता है. इससे कई यू-टर्न से बचा जा सकता है. इससे वाहन को किसी खास दिशा से विज़िट की जगह पर पहुंचने में मदद मिलती है. इससे यू-टर्न लेने की ज़रूरत नहीं पड़ती.
आपको यू-टर्न से बचने की सुविधा का इस्तेमाल तब करना चाहिए, जब पैदल चलकर सड़क पार करना सुरक्षित हो, ताकि आप विज़िट की जगह पर पहुंच सकें. अगर सड़क पार करने की अनुमति नहीं है या ऐसा करना मुमकिन नहीं है, तो sideOfRoad को true पर सेट करें.
sideOfRoad प्रॉपर्टी को Waypoint ऑब्जेक्ट में तय किया जाता है.
अन्य सुविधाओं के साथ इंटरैक्शन
यू-टर्न से बचने की सुविधा, रूटिंग की अन्य सुविधाओं के साथ इन तरीकों से इंटरैक्ट करती है:
- सड़क के किनारे:
avoidUTurnsऔरsideOfRoad, दोनों कोtrueपर सेट करने से, वाहन को सड़क के उस किनारे पर ले जाने की संभावना थोड़ी बढ़ जाती है जो विज़िट की जगह के सबसे करीब है. इससे यू-टर्न लेने से बचा जा सकता है. हालांकि, ऐसा करने से यू-टर्न से बचने की पाबंदियों से जुड़ी समस्याएं बढ़ जाती हैं. ज़्यादातर जगहों पर जाने के लिए, इन प्रॉपर्टी में से सिर्फ़ एक को सेट करने से यू-टर्न से बचा जा सकता है. - इंजेक्ट किए गए समाधान: यू-टर्न से बचने की सुविधा का इस्तेमाल करने पर, एपीआई से मिले जवाब में जनरेट किए गए
ShipmentRoute.Visitके अंदरinjectedSolutionLocationTokenशामिल होता है. इससे यह रिकॉर्ड किया जाता है कि सड़क के किस हिस्से को चुना गया है. अगर आपको आने वाले समय में किसी अनुरोध में इस विज़िट का फिर से इस्तेमाल करना है, तो आपको इस टोकन को एपीआई पर वापस भेजना होगा.
सीमाएं
यू-टर्न से बचने की सुविधा, पूरी कोशिश के साथ काम करती है. इन स्थितियों में, एपीआई जनरेट किए गए रास्ते में यू-टर्न शामिल कर सकता है:
- यात्रा के मोड को
DRIVINGके अलावा किसी अन्य मोड पर सेट किया गया हो. - विज़िट की गई किसी जगह पर पहुंचने और वहां से निकलने की जगहें अलग-अलग हैं. ऐसे में, एपीआई गड़बड़ी का मैसेज दिखाता है.
- जगह एक ऐसी सड़क पर है जो आगे जाकर बंद हो जाती है. इसलिए, वहां से निकलने के लिए यू-टर्न लेना पड़ता है.
- यू-टर्न, विज़िट की असल जगह के बजाय रास्ते में होता है.
- यह निर्देश, किसी दूसरी सड़क पर बहुत तेज़ मोड़ लेने के लिए है. एपीआई इसे यू-टर्न के तौर पर नहीं दिखाता.