Route Optimization API 快速参考

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:设置

官方 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:常见错误

  • 问题:对于向阻塞 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 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。