Route Optimization API 可根据您提供的目标和限制条件(例如时间范围、车辆容量、驾驶员工作时间和费用),为车队分配任务和路线,从而优化路线。您可以通过 REST、gRPC 或客户端库调用该 API,它会返回拜访顺序、配送任务分配、预计时间和路线指标。
Route Optimization API:关键信息
- 产品:Route Optimization API
- 别名:GMPRO
- 类别:路线
- 平台:Web 服务 (REST)
- 运行位置:服务器(后端代码)
- 发布阶段:GA
- 生命周期:有效
- 概览:Route Optimization API 概览
Route Optimization API:何时使用
在以下情况下使用 Route Optimization API:
- 您需要将配送或任务分配给多辆车辆,同时考虑时间范围、车辆容量、司机工作时间和成本。
- 您需要为一辆车规划最佳经停点顺序,以便完成多项接送、配送或预约服务。
- 您需要使用
injectedFirstSolutionRoutes或injectedSolutionConstraint针对新订单(例如按需派单)重新优化有效路线。 - 您需要为优化方案的每个路段获取路线令牌,以便传递给 Navigation SDK。
在以下情况下,请勿使用 Route Optimization API:
- 您需要实时跟踪司机执行计划的情况;该 API 返回的是规划的多段线,而不是实时车辆路线。请改用 Fleet Engine Service。
- 您需要为驾驶员提供应用内精细导航,引导他们沿着优化后的路线行驶。请改用 Navigation SDK for Android。
- 您需要为 iOS 上的司机提供应用内精细导航,引导他们沿着优化后的路线行驶。请改用 Navigation SDK for iOS。
Route Optimization API:设置
- 要启用的服务:
routeoptimization.googleapis.com - 身份验证:OAuth 2.0、服务账号
- 开始使用:设置 Route Optimization API
- 参考文档:Route Optimization API 参考文档
- 价格:Route Optimization API 用量和结算
- 政策:Route Optimization API 政策
- 版本说明:Route Optimization API 版本说明
官方 Route Optimization API 软件包:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API:相关产品
- 通常与以下产品搭配使用:Navigation SDK for Android、Navigation SDK for iOS、Fleet Engine Service、Maps JavaScript API
Route Optimization API:常见错误
- 问题:对于向阻塞
OptimizeTours端点发出的 REST 调用,默认的 60 秒时限会覆盖任何大于 60 秒的请求正文timeout。解决方法:设置X-Server-Timeout标头(以秒为单位,不带“s”后缀)以延长截止时间。客户端库和 gRPC 默认设置为 3600 秒。请参阅 /maps/documentation/route-optimization/timeouts。 - 问题:
timeout和截止时间值的上限为 1800 秒。解决方法:将allowLargeDeadlineDespiteInterruptionRisk设置为true,以允许最长 3, 600 秒,但会面临更高的中断错误风险。请参阅 /maps/documentation/route-optimization/timeouts。 - 问题:如果没有费用参数(例如
costPerHour或costPerKilometer),优化器会将所有解决方案视为等同。修正方法:在车辆上定义反映业务费用的费用参数。请参阅 /maps/documentation/route-optimization/make-first-request。 - 问题:使用 API 密钥进行身份验证的请求失败;每个请求都需要 OAuth 令牌。解决方法:使用具有
https://www.googleapis.com/auth/cloud-platform范围的 OAuth 令牌,例如通过应用默认凭证或服务账号。请参阅 /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token。
Route Optimization API 的用途
请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。
- 返回多经停点配送计划,该计划会根据指定的路线、费用、配送和车辆限制进行优化。
- 返回优化后的配送方案中每个经停点的开始和结束时间。
- 返回优化后的配送方案中每个停靠点之间的行程、延迟、休息和等待时长。
- 返回优化后的配送方案中每个停靠点的车辆载重信息。
- 返回优化后的配送方案中每项配送任务的费用信息。
- 返回优化后的配送方案中每个经停点之间路线的编码多段线。
- 返回优化后的配送方案中各停靠点之间路线的导航路线令牌。
- 返回优化配送方案的汇总配送、车辆和费用指标。
- 为多站配送计划指定开始和结束时间范围。
- 为多站配送方案中的每辆车指定开始和结束时间以及地点。
- 为多经停点配送方案中的每辆车指定车辆时间费用。
- 为多站配送方案指定费用模型参数。
- 为多站配送计划中的每项配送指定取件和送货时间限制。
- 为多经停点配送计划指定车辆分配。
- 在多站配送计划中为每辆车指定载重限制。
- 指定是否在多经停点配送方案中考虑实时路况信息。
- 批量处理多站配送计划优化请求,并将响应写入 Google Cloud Storage。
- 在送货前预留停车时间。
- 优先安排连续拜访附近的客户。
- 避免在多停靠点车辆路线中掉头。实验性 注意:实验性功能;受正式发布前条款和限制约束。
- 针对预定义的目标进行优化。实验性 注意:实验性功能;受正式发布前条款和限制约束。
- 优先配送较重的货物。实验性 注意:实验性功能;受正式发布前条款和限制约束。