रास्ते में किसी स्टॉप को दो तरीकों से सेट किया जा सकता है. जैसे, किसी को पिक अप या ड्रॉप ऑफ़ करने के लिए:
- इंटरमीडिएट वेपॉइंट जोड़ें: यह डिफ़ॉल्ट विकल्प है.
intermediatesकलेक्शन में, यात्रा शुरू करने की जगह और मंज़िल के बीच में कोई इंटरमीडिएट वेपॉइंट जोड़ें. रास्ता तय करने वाला इंजन, वेपॉइंट को सबसे नज़दीकी सड़क पर स्नैप करता है. इसके बाद, रास्ते कोRouteLegसेगमेंट में बांटता है. ये सेगमेंट, उस स्टॉप से कनेक्ट होते हैं. - vehicleStopover की जानकारी दें: अगर आपको रूटिंग इंजन से यह विश्लेषण कराना है कि रास्ते में रुकने के लिए कौनसी जगहें सही नहीं हैं, तो किसी वेपॉइंट पर
vehicleStopover: trueसेट करें. जैसे, हाइवे, सुरंगें या ओवरपास.
रास्ते में पड़ने वाला वेपॉइंट जोड़ें
किसी रूट में स्टॉप सेट करने के लिए, अपने अनुरोध में intermediates कलेक्शन में इंटरमीडिएट वेपॉइंट जोड़ें.
इंटरमीडिएट वेपॉइंट जोड़ने से ये असर पड़ते हैं:
- रास्ता
RouteLegसेगमेंट में बंटा होता है: हर सेगमेंट, एक स्टॉप को दूसरे स्टॉप से कनेक्ट करता है. - निर्देशांक, सड़क पर स्नैप हो जाता है: रूटिंग इंजन, आपके अक्षांश और देशांतर निर्देशांक को स्नैप करता है. ये निर्देशांक, छत पर या किसी यार्ड में हो सकते हैं. इसके बाद, रूटिंग इंजन इन निर्देशांकों को सड़क के सबसे नज़दीकी हिस्से पर स्नैप कर देता है.
ज़्यादातर सड़कों के लिए, सबसे नज़दीकी सड़क पर स्नैप करने से, रुकने की सही जगह मिल जाती है. हालांकि, स्नैपिंग से यह पता नहीं चलता कि सड़क का वह हिस्सा गाड़ी रोकने के लिए सही है या नहीं. जैसे, जब सबसे नज़दीकी सड़क कोई हाइवे या सुरंग हो.
उदाहरण: बीच में एक वेपॉइंट जोड़ना
यहां दिए गए उदाहरण में, computeRoutes POST अनुरोध में इंटरमीडिएट वेपॉइंट जोड़कर, किसी रास्ते पर स्टॉप सेट करने का तरीका बताया गया है:
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
रास्ते में पड़ने वाले वेपॉइंट और रूट लेग के बारे में ज़्यादा जानने के लिए, रास्ते में पड़ने वाले वेपॉइंट सेट करना लेख पढ़ें.
पिकअप और ड्रॉप-ऑफ़ के लिए, vehicleStopover तय करना
स्टैंडर्ड इंटरमीडिएट वेपॉइंट, सबसे नज़दीकी सड़क पर स्नैप होता है. हालांकि, यह ज़रूरी नहीं है कि वह सड़क, वाहन रोकने के लिए हमेशा सही हो. अगर आपको पिकअप या ड्रॉप-ऑफ़ के लिए सड़क की उपयुक्तता का आकलन करने के लिए, राउटिंग इंजन से अतिरिक्त विश्लेषण कराना है, तो वेपॉइंट पर vehicleStopover: true सेट करें.
vehicleStopover: true सेट करने पर, रास्तों का पता लगाने वाला इंजन, सड़क के संभावित सेगमेंट का आकलन करता है. साथ ही, उन सड़कों से बचने की कोशिश करता है जहां रुकना सही नहीं है. जैसे, फ़्रीवे, सुरंगें, और ओवरपास.
उदाहरण के लिए, ऐसी जगह पर विचार करें जहां सुरंग के अंदर मौजूद हाइवे के ठीक ऊपर एक सड़क है: * स्टैंडर्ड इंटरमीडिएट वेपॉइंट: अगर यह आपके कोऑर्डिनेट के हिसाब से ज्यामितीय रूप से ज़्यादा करीब है, तो यह हाइवे या उसके नीचे मौजूद सुरंग पर स्नैप हो जाता है. * वाहन रोकना: यह सुविधा, हाइवे और सुरंग को बायपास करने के लिए अतिरिक्त विश्लेषण करती है. साथ ही, वाहन को ऐसी सड़क पर रोकती है जहां वाहन को रोकना सुरक्षित हो.
उदाहरण: किसी वेपॉइंट पर vehicleStopover तय करना
यहां दिए गए उदाहरण में, पूरे POST अनुरोध में इंटरमीडिएट वेपॉइंट पर vehicleStopover: true सेट करने का तरीका बताया गया है:
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } }, "vehicleStopover": true } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
वेपॉइंट के टाइप और विकल्पों के बारे में ज़्यादा जानने के लिए, वेपॉइंट के टाइप और विकल्प लेख पढ़ें.