路線控點最佳化是 Routes Preferred 功能
ComputeRoutes
。
這個服務會調整旅客路線中的中繼路線控點順序,確保他們能以最有效率的方式前往目的地。ComputeRoutes
路線控點最佳化實作支援下列交通方式:
- 開車
- 電動機車
- 單車運動
- 步行
為什麼要使用路線控點最佳化功能?
建構應用程式時,引導使用者行經多個路線控點 某個目的地時,旅客必須通過 最佳順序。這樣才能確保旅客抵達 作業時間
運作方式
根據預設,ComputeRoutes
會依照路線控點原本提供的順序,計算路線。您可以取得 ComputeRoutes
,藉由更有效率的順序重新排列中繼路線控點,以便規劃最佳路線。如果您將要求主體中的 optimizeWaypointOrder
欄位設為 true
,系統就會傳回含有最佳化路線控點的路線。
注意:路線控點最佳化的計算方式主要以交通時間為準 但這項功能也會考量距離等其他因素 以及轉彎次數。
取得重新排序的路線控點
如要取得已重新排序路線控點的路線,請設定布林值欄位
在要求主體中將 optimizeWaypointOrder
傳送至 true
ComputeRoutes
。此外,請在欄位遮罩中加入 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"}
回應範例
您可以在回應主體的 routes 物件中,找到 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 公里,這項距離包含起點和目的地。
交通模式必須是 DRIVE。