इंटरमीडिएट वेपॉइंट सेट करें

बीच के वेपॉइंट, शुरुआत की जगह और मंज़िल के बीच की वे जगहें हैं जहां से आपको रास्ता भेजना है. इंटरमीडिएट वेपॉइंट, कोई स्टॉप हो सकता है या उसे किसी ऐसी जगह के तौर पर तय किया जा सकता है जहां से होकर गुज़रना हो. किसी स्टॉप के वेपॉइंट के उदाहरण के लिए, किसी रास्ते पर स्टॉप सेट करें देखें. पास-थ्रू के लिए वेपॉइंट के उदाहरण के लिए, पास-थ्रू के लिए रास्ते का पॉइंट सेट करें.

ज़्यादा से ज़्यादा 25 इंटरमीडिएट वेपॉइंट तय करने के लिए, ComputeRoutes तरीके (REST) या ComputeRoutes तरीके (gRPC) की intermediates ऐरे प्रॉपर्टी का इस्तेमाल करें.

अनुरोध में मौजूद हर इंटरमीडिएट वेपॉइंट के लिए, रिस्पॉन्स में मौजूद रूट ऑब्जेक्ट (REST) या रूट ऑब्जेक्ट (gRPC), legs ऐरे में एक एंट्री जोड़ता है. ऐसा इसलिए किया जाता है, ताकि सफ़र के उस चरण की जानकारी दी जा सके.

रास्ते की हर लेग को RouteLeg (REST) या RouteLeg (gRPC) ऑब्जेक्ट से दिखाया जाता है. रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल करके कंट्रोल करें कि कौनसे RouteLeg फ़ील्ड दिखाए जाएं.

उदाहरण - इंटरमीडिएट वेपॉइंट सेट करना

इस उदाहरण में, किसी रूट के POST अनुरोध के मुख्य हिस्से में एक इंटरमीडिएट वेपॉइंट जोड़ने के लिए, intermediates ऐरे प्रॉपर्टी का इस्तेमाल किया गया है.

इस उदाहरण में, X-Goog-FieldMask हेडर में रिस्पॉन्स फ़ील्ड मास्क का इस्तेमाल किया गया है. इससे पता चलता है कि रिस्पॉन्स में इन फ़ील्ड को दिखाया जा सकता है:

  • routes.duration
  • routes.distanceMeters
  • पूरे RouteLeg ऑब्जेक्ट के साथ routes.legs.
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": [
                {
                  ...