默认情况下,Routes API 会返回默认路线,该路线通常是从起点到终点的最快路线。当您请求替代路线时,API 会返回最多三条路线以及默认路线。然后,您的客户可以选择最符合其要求的路线。
请求替代路线时的注意事项
如需请求替代路线,请注意以下事项:
您只能为没有中间途经点的路线请求替代路线。当路线指定中间途经点时,请求备选路线不会导致错误。不过,系统未返回任何替代路线。
响应最多包含 3 条替代路线。不过,有时没有替代路线,因此响应仅包含默认路线。
由于计算备选路线需要额外的处理,因此请求备选路线可能会增加 API 的响应时间。
替代路线请求示例
将 computeAlternativeRoutes
设置为 true
以请求备选路线。以下示例展示了如何在 computeRoutes 方法 (REST) 请求中请求替代路线。
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "routingPreference":"TRAFFIC_AWARE", "computeAlternativeRoutes": true }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
在此示例中,您指定了一个字段掩码,以便响应仅包含每个路线的 duration
、distanceMeters,
和 routeLabels
属性。然后,您的客户可以使用这些信息来选择要走的路线。如需了解详情,请参阅选择要返回的信息。
备选路线响应示例
在响应中,使用 routeLabels
数组属性来识别覆盖面路线:
对于默认路由,
routeLabels
属性包含DEFAULT_ROUTE
。对于任何备选路线,
routeLabels
属性都包含DEFAULT_ROUTE_ALTERNATE
。
在此示例中,响应包含默认路线和两条替代路线。请注意,每条路线的 duration
和 distanceMeters
属性的值都不同:
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }
在响应中包含折线
为了方便用户选择路线,请将每条路线的折线添加到响应中。然后,您可以在地图上显示每条多段线。
如需添加多段线,请在字段掩码中添加 routes.polyline
:
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'
然后,响应会包含每条路线的折线:
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "polyline": { "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "polyline": { "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "polyline": { "encodedPolyline": "FVLL|Af@HPAV…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }