इंटरमीडिएट वेपॉइंट, यात्रा शुरू करने की जगह और मंज़िल के बीच की ऐसी जगहें होती हैं जहां आपको रास्ता बनाना है. बीच का कोई वेपॉइंट, स्टॉप हो सकता है या इसे किसी ऐसी जगह के तौर पर सेट किया जा सकता है जहां से गुज़रना है. स्टॉप के लिए व्यूपॉइंट का उदाहरण देखने के लिए, रास्ते में स्टॉप सेट करना लेख पढ़ें. रास्ते के बीच में मौजूद किसी पॉइंट को सेट करना लेख पढ़ें.
ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट तय करने के लिए, computeRoutes तरीके (REST) या ComputeRoutes तरीके (gRPC) की intermediates
कलेक्शन प्रॉपर्टी का इस्तेमाल करें.
अनुरोध में मौजूद हर इंटरमीडिएट वेपॉइंट के लिए, रिस्पॉन्स में मौजूद Route ऑब्जेक्ट (REST) या Route ऑब्जेक्ट (gRPC), legs
कलेक्शन में एक एंट्री जोड़ता है. इससे, सफ़र के उस हिस्से की जानकारी मिलती है.
किसी रास्ते के हर चरण को RouteLeg (REST) या RouteLeg (gRPC) ऑब्जेक्ट से दिखाया जाता है.
रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करके, यह कंट्रोल करें कि कौनसे RouteLeg
फ़ील्ड दिखाने हैं.
उदाहरण - बीच में एक वेपॉइंट सेट करना
यहां दिए गए उदाहरण में, intermediates
कलेक्शन प्रॉपर्टी का इस्तेमाल करके, किसी रास्ते के पोस्ट अनुरोध के मुख्य हिस्से में एक इंटरमीडिएट वेपॉइंट जोड़ा गया है.
इस उदाहरण में, X-Goog-FieldMask
हेडर में रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल किया गया है. इससे रिस्पॉन्स में ये फ़ील्ड दिखाए जाते हैं:
routes.duration
routes.distanceMeters
routes.legs
, पूरेRouteLeg
ऑब्जेक्ट से जुड़ा है.
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } }, "sideOfRoad": true }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } } } ], "travelMode": "DRIVE", "routingPreference": "TRAFFIC_AWARE", "departureTime": "2022-10-15T15:01:23.045123456Z", "computeAlternativeRoutes": false, "routeModifiers": { "avoidTolls": false, "avoidHighways": false, "avoidFerries": false }, "languageCode": "en-US", "units": "IMPERIAL" }' -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'
इस कॉल के रिस्पॉन्स में legs
कलेक्शन शामिल है. लेग के हर चरण को RouteLegStep (REST) या RouteLegStep (gRPC) ऑब्जेक्ट से दिखाया जाता है.
{ "routes": [ { "legs": [ # First leg { "distanceMeters": 207, "duration": "89s", "staticDuration": "89s", "polyline": { "encodedPolyline": "ipkcFjgchVd@@@cF]@@oCK?" }, "startLocation": { "latLng": { "latitude": 37.4197318, "longitude": -122.0826233 } }, "endLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.08077919999998 } }, "steps": [ { "distanceMeters": 21, "staticDuration": "6s", "polyline": { "encodedPolyline": "ipkcFjgchVd@@" }, "startLocation": { "latLng": { "latitude": 37.4197318, "longitude": -122.0826233 } }, "endLocation": { "latLng": { "latitude": 37.41954, "longitude": -122.08262750000002 } } }, ... }, # Second leg { "distanceMeters": 598, "duration": "159s", "staticDuration": "159s", "polyline": { "encodedPolyline": "ipkcFz{bhVh@??{@xPBP?J}E{E?" }, "startLocation": { "latLng": { "latitude": 37.419734, "longitude": -122.08077919999998 } }, "endLocation": { "latLng": { "latitude": 37.417616599999995, "longitude": -122.07938820000001 } }, "steps": [ { ...