如要在路線上設定停靠點 (例如接送地點),可以透過下列兩種方式:
- 新增中途停靠點:這是預設選項。在
intermediates陣列中,於起點和目的地之間新增中途停靠點。路徑引擎會將途中的停靠點對應至最近的可導航道路,並將路徑劃分為RouteLeg個路段,這些路段會由該停靠點連接。 - 指定 vehicleStopover:如要讓路徑引擎執行額外分析,避免在不適合停車的路段 (例如高速公路、隧道或高架橋) 停車,請在路徑點上設定
vehicleStopover: true。
新增中途航點
如要設定路線中的停靠點,請在要求中的 intermediates 陣列新增中途航點。
新增中途停靠點會產生下列影響:
- 路線會分成
RouteLeg多個路段:每個路段會連接一個停靠站到下一個停靠站。 - 座標會對齊道路:路徑引擎會將您的經緯度座標 (可能位於屋頂或庭院) 對齊最近的可導航路段。
對於許多平面道路,貼齊最近的道路可提供實用的停靠位置。不過,路段對齊功能不會判斷該路段是否適合靠邊停車,例如最近的道路是高速公路或隧道時。
範例:新增中途路線點
以下範例說明如何透過在 computeRoutes POST 要求中新增中途航點,在路線上設定停靠點:
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } } } ], "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' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
如要進一步瞭解中途路線控點和路段,請參閱「設定中途路線控點」。
指定取貨和送達地點的 vehicleStopover
標準中途停靠點會自動對齊最近的道路,但該道路不一定適合車輛停靠。如要讓路徑引擎執行額外分析,評估道路是否適合上車或下車,請在路徑點上設定 vehicleStopover: true。
設定 vehicleStopover: true 後,路徑引擎會評估候選路段,並嘗試避開不適合停車的路段,例如高速公路、隧道和高架橋。
舉例來說,假設某個地點的平面道路直接通過隧道內的公路: * 標準中途航點:如果幾何上更靠近您的座標,系統會將航點對齊下方的公路或隧道。 * 車輛中途停靠:執行額外分析,略過高速公路和隧道,將停靠點對齊適合靠邊停車的平面道路。
範例:在途中的停靠點指定 vehicleStopover
以下範例說明如何在完整的 POST 要求中,對中途停靠點設定 vehicleStopover: true:
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0827784 } } }, "destination":{ "location":{ "latLng":{ "latitude": 37.417670, "longitude": -122.079595 } } }, "intermediates": [ { "location":{ "latLng":{ "latitude": 37.419734, "longitude": -122.0807784 } }, "vehicleStopover": true } ], "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' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
如要進一步瞭解路線控點類型和選項,請參閱路線控點類型和選項。