設定路線傳遞點

根據預設，中繼路線控點會用於停靠上車和下車地點，但您也可以指定中繼路線控點僅用於傳遞。

包含起點路線控點、直通中繼路線控點和目的地路線控點的路徑只會包含一個路線路段，連接起點與目的地，同時通過中繼路線控點 (稱為 via) 路線控點。

使用 Waypoint (REST) 或 Waypoint (gRPC) 將路線控點的 via 屬性設為 true，即可將中繼路線控點設為直通路線控點。

建立路線來回應使用者在地圖上拖曳路線控點時，via 屬性最為有效。如此一來，使用者就能即時查看最終路線的樣子，並確保路線控點都放在 Compute Routes 可存取的位置。

以下範例說明如何將中繼路線控點標示為直通路線控點。

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

存取中繼路線控點的地點 ID

如果您使用「地址字串」或「Plus Code」指定起點、目的地或中繼路線控點的位置，API 會嘗試找出具有對應地點 ID 的最相關地點。結果中的 geocodingResults.intermediates 陣列包含路線控點位置對應的地點 ID，以及該位置的其他相關資料。

針對 intermediates 陣列的每個元素，使用 intermediateWaypointRequestIndex 屬性來決定要求中的哪一個中繼路線點對應到回應中的地點 ID。

例如：

  • 您在要求中指定三個中繼路線控點。其中兩個路線控點是由地址字串和經緯度座標指定。

  • 您可以在回應欄位遮罩中加入 geocodingResults，以指定在結果中傳回 geocodingResults 陣列。

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "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,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

回應包含 geocodingResults 陣列，其中包含起點、目的地和三個路線控點中兩個地點的地點 ID。這些是要求的索引 0 和 2 的路線點。由於要求中索引 1 的路線點是使用緯度/經度座標指定的路線點，因此會從回應的 geocodingResults 陣列中省略該路線。

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}