航点优化是“路线优选”的一项功能,扩展了 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"}
示例响应
您可以在响应正文中路线对象的 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
请求标头的值设置为至少 10 秒,为方法调用设置更长的超时。如果您继续收到超时错误,可以再增加一秒钟,然后重试。
使用限制
如需使用航点优化,您必须遵循以下使用限制和条件:
您最多可以为路线上的中间航点指定用量限额:
- 仅使用纬度和经度坐标时,最多可使用 98 个航点。
- 如果您使用地点 ID 指定任何航点,则最多可指定 25 个航点。
所有航点都必须是 stopover 类型。所有航点都不能是 via 类型。
您必须将
routes.optimizedIntermediateWaypointIndex
添加到字段掩码中。如果您的请求包含 25 个或更多中间航点,则还必须满足以下条件:
所有航点之间的累计直线距离必须小于 1000 公里。此距离包括出发地和目的地。
出行方式必须为云端硬盘。