設定中繼路線控點

中繼路線控點是指您希望路線經過的起點和目的地之間的位置。中繼路線控點可以是停靠站，也可以指定為要通過的位置。如需停靠站的路線控點範例，請參閱「沿著路線設定停靠站」。如需直通的路線點範例，請參閱設定直通路線的點。

使用 computeRoutes 方法 (REST) 的 intermediates 陣列屬性或 ComputeRoutes 方法 (gRPC)，定義最多 25 個中繼路線控點。

對於要求中的每個中繼路線控點，回應中的路徑物件 (REST) 或路徑物件 (gRPC) 會在 legs 陣列中新增項目，以提供旅程路段的詳細資料。

路線的每個路段都以 RouteLeg (REST) 或 RouteLeg (gRPC) 物件表示。使用回應欄位遮罩來控制要傳回的 RouteLeg 欄位。

範例 - 設定中繼路線控點

以下範例使用 intermediates 陣列屬性，在路徑的 POST 要求主體中新增單一中繼路線控點。

這個範例在 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": [
                {
                  ...