中途點最佳化是 Routes Preferred 功能的延伸功能，可提供ComputeRoutes。這項功能會調整旅客路線中的中途控點順序，確保他們走的是最有效率的路線。ComputeRoutes 航點最佳化實作支援下列交通方式：
- 開車
- 電動機車
- 單車運動
- 散步
為什麼要使用路線控點最佳化？
建構應用程式時，如果會引導使用者前往目的地，途中經過多個航點，請務必確保旅客以最佳順序經過航點。這可確保旅客在最短時間內抵達每個中途點。
運作方式
根據預設，ComputeRoutes 會依原始提供的順序，計算通過路線控點的路線。您可以取得 ComputeRoutes，將中間路線控點重新排列成更有效率的順序，藉此規劃出最佳路線。如果將要求主體中的 optimizeWaypointOrder 欄位設為 true，您會收到路線，其中包含最佳化的路線控點。
注意：系統主要會根據交通時間計算最佳路徑，但也會考量其他因素，例如距離和轉彎次數。
取得重新排序的途經點
如要取得重新排序途中的路線，請在對 ComputeRoutes 提出的要求主體中，將布林值欄位 optimizeWaypointOrder 設為 true。此外，請在欄位遮罩中加入 optimizedIntermediateWaypointIndex 欄位。回覆主體包含 optimizedIntermediateWaypointIndex 欄位中最佳化的中途點順序。
注意：optimizedIntermediateWaypointIndex 欄位會傳回從零開始計算的值。
要求範例
以下範例要求提供史丹佛大學校園附近的路線。路線控點已依序在要求中提供。要求包含起點和目的地，以及兩個中間路線控點。
POST /v1alpha:computeRoutes
Host: routespreferred.googleapis.com
Content-Type: application/json
X-Server-Timeout: 10
X-Goog-Api-Key: YOUR_API_KEY
X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
{
"origin":{
"location":{
"latLng":{
"latitude": 37.418956,
"longitude": -122.160815
}
}
},
"intermediates": [
{
"location":{
"latLng":{
"latitude": 37.4176423,
"longitude":-122.1102246
}
}
},
{
"location":{
"latLng":{
"latitude": 37.407689,
"longitude": -122.1360597
}
}
}
],
"destination":{
"location":{
"latLng":{
"latitude": 37.4032137,
"longitude": -122.0349119
}
}
},
"travelMode": "DRIVE",
"optimizeWaypointOrder": true,
"routingPreference": "TRAFFIC_AWARE"}
回應範例
您可以在回應主體的路線物件中，找到 optimizedIntermediateWaypointIndex 欄位內重新排序的中間途經點索引。編碼的折線與 Directions API 和 ComputeRoutes 中的相同。
routes {
distance_meters: 17647
duration {
seconds: 1866
}
polyline {
encoded_polyline: "wkkcFvorhVU{@Ec@C}CG}@Mm@[}@i@y@[[g@_@Tk@BSjCgGfF|D\\Pv@Lj@@XaCTeC\\aCTs@`ByD`@k@h@e@x@Yh@GtADhBF|@G`AWpAs@lAsAdA{A`BmDr@cBmUqQoS}OyGmFiBsAgEwD}CaCU_@Og@@e@Hy@nGkO~@sBr@cBlDqIlByEp@}AjIfGnBbBHLLd@^p@~ErDfNrKrA~@DIhEeBTQ~AqDlE{KjBgE|FnEh@aAi@`A}FoE~AmD`A}BcAm@mHwFwD}CkLwIsDqCgF_EG[GKnCsDrA_BrC_CnCoBpEkD`EyClCsBcBeBIAkGkH]k@eJmKQKsAuA_@g@wCoDGQmEmFmIqROKaDuHvBkBxAgANCRH^f@v@dBHDD?`AUiBqEhBpEaATMCQYm@wAY]SIOByAfAwBjB_ByDaAwBiCeIA[c@aBqEuNOm@IQbA{c@p@aZFmCTuBLg@Tc@BUAKxOeV~Vy_@nBoDv@_BvAcDzA_EdG{RdC{HtIsY|B{Hx@mDbAuFdBsMbKsv@TaBf@}AdF{Sn@_DJq@Lo@aE`@]GUQmAmAQk@@g@RK`Ce@d@UDEPc@f@cCrAyGJs@X{AbIem@bA{JD_AIaAMg@o@{A_Ad@y@NaCLCsCK_FGI"
}
optimizedIntermediateWaypointIndex: 1
optimizedIntermediateWaypointIndex: 0
}
在本例中，請注意最佳化路線控點會反轉原始順序。
建議做法
與簡單的路線規劃要求相比，使用最佳化路線控點的要求需要較長的處理時間。因此，建議您為 X-Server-Timeout 要求標頭設定至少十秒的值，在方法呼叫中設定較長的逾時時間。如果仍收到逾時錯誤，可以再增加一秒，然後重試。
使用限制
如要使用中途點最佳化功能，必須遵守下列使用限制和條件：
您最多可以為路線上的中途停靠點指定用量限制：
- 最多 98 個航點，僅使用經緯度座標。
- 如果使用地點 ID 指定任何中途點，最多可指定 25 個中途點。
所有路線控點都必須是「停靠點」類型。所有途中的航點都不能是 via 類型。
您必須在欄位遮罩中新增
routes.optimizedIntermediateWaypointIndex。如果要求包含 25 個以上的途經點，也必須遵守下列條件：
所有航點之間的累計直線距離必須小於 1,000 公里，包括起點和目的地。
交通方式必須是「開車」。