रास्ते में कोई स्टॉप सेट करने के दो तरीके हैं. जैसे, बस पकड़ने या उतरने के लिए स्टॉप सेट करना:
- रास्ते में एक वेपॉइंट जोड़ना: डिफ़ॉल्ट तौर पर यही विकल्प लागू होता है.
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'
वेपॉइंट के टाइप और विकल्पों के बारे में ज़्यादा जानने के लिए, वेपॉइंट के टाइप और विकल्प लेख पढ़ें.