根據預設,中繼路線控點會用於停靠上車和下車地點,但您也可以指定中繼路線控點只會用來傳遞。
包含起點路線、直通中繼路線點和目的地路線控點的路線僅包含一個路線路段,可連接起點和目的地,同時通過中繼 (稱為 via
) 路線點。
使用 Waypoint (REST) 或 Waypoint (gRPC),將路線控點的 via
屬性設為 true
,即可將中繼路線控點設定為直通路線點。
via
屬性最適合用於回應使用者在地圖上拖曳路線點時建立路線。這樣一來,使用者就能即時查看最終路線,並確保路標放置在可供計算路線存取的位置。
以下範例說明如何將中繼路線控點標示為直通路線點。
{ "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" } ] } }