इंटरमीडिएट वेपॉइंट, ऑरिजिन और डेस्टिनेशन के बीच की वे जगहें होती हैं जहां से होकर आपको रास्ता चाहिए.
REST computeRoutes तरीके या gRPC ComputeRoutes तरीके की intermediates कलेक्शन प्रॉपर्टी का इस्तेमाल करके, एक अनुरोध में ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट तय किए जा सकते हैं.
स्टॉपओवर बनाम पास-थ्रू वेपॉइंट
किसी इंटरमीडिएट वेपॉइंट को स्टॉप या पास-थ्रू जगह के तौर पर कॉन्फ़िगर किया जा सकता है:
- स्टॉपओवर: डिफ़ॉल्ट रूप से, वाहन इस जगह पर रुकता है. हर स्टॉपओवर वेपॉइंट, जवाब में मौजूद
legsकलेक्शन मेंRouteLegएंट्री जोड़कर, रास्ते को हिस्सों में बांटता है. ज़्यादा जानकारी के लिए, किसी रास्ते पर स्टॉप सेट करना लेख पढ़ें. - पास-थ्रू वेपॉइंट के लिए,
"via"कोtrueपर सेट करें: वाहन इस जगह पर रुके बिना गुज़रता है. पास-थ्रू वेपॉइंट,legsकलेक्शन में एंट्री नहीं जोड़ते. ज़्यादा जानकारी के लिए, किसी रास्ते के लिए पास-थ्रू पॉइंट सेट करना लेख पढ़ें.
रास्ते के हिस्से और इंटरमीडिएट वेपॉइंट
अनुरोध में मौजूद हर इंटरमीडिएट स्टॉपओवर के लिए, जवाब में एक
अलग RouteLeg ऑब्जेक्ट
routes.legs कलेक्शन में होता है.
उदाहरण के लिए, ऑरिजिन, एक इंटरमीडिएट स्टॉपओवर, और डेस्टिनेशन वाले रास्ते में दो रूट लेग होते हैं: * लेग 1: ऑरिजिन से इंटरमीडिएट स्टॉपओवर तक. * लेग 2: इंटरमीडिएट स्टॉपओवर से डेस्टिनेशन तक.
उदाहरण: इंटरमीडिएट वेपॉइंट वाला अनुरोध
यहां दिए गए उदाहरण में, किसी रास्ते में एक इंटरमीडिएट स्टॉपओवर जोड़ने के लिए, intermediates कलेक्शन का इस्तेमाल किया गया है.
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'
एक से ज़्यादा रूट लेग वाला जवाब
अनुरोध में मौजूद इंटरमीडिएट वेपॉइंट एक स्टॉपओवर है. इसमें
सेट "via": true नहीं है. इसलिए, जवाब में
legs कलेक्शन में रास्ते को दो हिस्सों में बांटा गया है:
{ "routes": [ { "distanceMeters": 805, "duration": "248s", "legs": [ { "distanceMeters": 207, "duration": "89s", "startLocation": { "latLng": { "latitude": 37.4197318, "longitude": -122.0826233 } }, "endLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } } }, { "distanceMeters": 598, "duration": "159s", "startLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.0807792 } }, "endLocation": { "latLng": { "latitude": 37.4176166, "longitude": -122.0793882 } } } ] } ] }