Routes API 的大型车辆路线规划功能可计算大型车辆的路线和预计到达时间 (ETA)。它会根据车辆高度、重量、长度和危险品分类，返回避开限制的优化路线。该服务还会生成一个路线令牌，该令牌可传递给 Navigation SDK，以提供精细导航。
为何使用大型车辆路线规划
使用大型车辆路线规划功能构建应用，为大型车辆车队解决物流难题。
| 优势 | 说明 |
|---|---|
| 提高定价和规划的准确性 | 生成具体的、基于流量信息的预计到达时间，以便为卡车和巴士等大型车辆提供更准确的报价和送达时间范围。 |
| 提高驾驶员的安全性和效率 | 引导司机沿路线行驶，避开低矮桥梁、限重道路和其他危险。 |
| 简化整个舰队的操作 | 将 Route Optimization 与大型车辆路线规划功能搭配使用，可优化整个车队的装载分配和经停点顺序。使用 Fleet Engine 实现任务和车辆位置的实时可见性。 |
| 减少培训并提高采用率 | 在您自己的应用中为大型车辆或卡车司机提供熟悉的 Google 地图导航体验 |
大型车辆路线规划的用途
借助大型车辆路线规划，您可以执行以下关键操作：
- 指定详细的车辆属性，包括高度、重量、长度、宽度、车轴数量和危险品分类。
- 获取专门针对车辆属性计算的路线、行程时间和行程距离。
- 生成针对机动性进行优化的路线，自动避开 U 形转弯，并优先选择州际公路和高速公路。这样可确保大型车辆行驶在满足驾驶员需求和期望的路线中。
- 使用卡车专用 ETA 模型计算更准确的 ETA。该模型将观测到的卡车行驶速度与实时和预测性流量数据相结合，从而为大型车辆提供更准确的估计。
- 使用路线令牌在 Navigation SDK 中启用精细导航，以从 Routes API 传输卡车安全路线。
- 计算路线矩阵，以确定多个出发地和目的地之间的行程时间和距离，从而进行车队范围的规划。
- 为卡车车队优化路线规划，以提高整体运营效率，同时兼顾可行性和安全性。
大型车辆路线规划的工作原理
大型车辆路线规划功能通过以下服务运行：
| 端点 | 操作 | 输出 |
|---|---|---|
| Routes API | 向 Routes API 端点（computeRoutes 或 computeRouteMatrix）发送 HTTPS 请求，请求正文中包含出发地和目的地。travelMode 必须设置为 TRUCK，并且 routeModifiers 对象必须包含 vehicleInfo。
|
路线多段线、路线路段和步骤列表、预计行程时间以及路线令牌。 |
| Route Optimization API | 向路线优化 API 端点发出的 HTTPS 请求。travelMode 必须设置为 TRUCK，并且 routeModifiers 对象必须包含 vehicleInfo。
|
针对特定车辆设计的优化车队路线规划，以及每次行程的路线令牌。 |
| Navigation SDK (Android、iOS) | 在导航器中设置目的地时，包含路线令牌（通过 Routes API 或 Route Optimization API 生成，并使用大型车辆路线规划）。 | 专为卡车量身定制的精细导航体验，遵循在原始 Routes API 或 Route Optimization API 请求中指定的车辆信息所对应的路线。 |
示例
以下示例重点介绍如何将大型车辆路线规划与 Routes API 搭配使用。
例如，一个基本的 computeRoutes 请求正文如下所示：
{
"origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
"destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
"travelMode": "TRUCK",
"routeModifiers": {
"vehicleInfo": {
"totalHeightMm": 4114,
"totalLengthMm": 21945,
"totalWeightKg": 32658,
... // other vehicle attributes
}
}
}
必需：您的请求必须将 travelMode 设置为 TRUCK，并使用车辆的具体尺寸和属性填充 vehicleInfo 对象。
Routes API 会返回一条考虑了指定车辆信息的路线。根据指定的 fieldmask，响应可以包含路线折线、卡车专用预计到达时间、行驶距离和用于 Navigation SDK 的路线令牌。响应还会指明是否找不到完全合规的路线。
请求和响应内容
下表列出了使用 Routes API 的 computeRoutes 方法发出大规模车辆路线规划请求时，您发送和接收的数据。
| 请求内容 | 响应内容 | 返回格式 |
|---|---|---|
|
|
JSON |
限制
在开始之前，您必须了解以下限制和要求。
- 适用地区：大型车辆路线规划功能已在美国本土 48 个州（正式版）和日本（实验版）推出。此功能在阿拉斯加、夏威夷或美国属地不可用。
- 驾驶员咨询和安全。驾驶员不得仅依赖此 API 返回的路线来确保安全或合法。我们无法保证路线适合车辆，如果按照路线行驶，驾驶员可能会遇到低矮桥梁或禁止大型车辆通行的道路等危险。
- 尽力而为的路线。在某些情况下，API 无法找到完全符合出行限制的路线。而是返回“尽力而为”的路线，该路线可能仍会经过受限区域。Routes API 响应会在
routeRestrictionsPartiallyIgnored字段中明确标记这些路线。在这种情况下，请仔细规划路线，最好使用其他来源的数据。请勿将标记的路线作为规划或导航的单一事实来源。 - 不支持的功能：大型车辆路线规划不支持以下功能：
- 卡车通行费
- 速度限制
- 放射性有害物质的路线
- 用量限额：所有请求均受标准每秒查询次数 (QPS) 限制的约束。
如何使用大型车辆路线规划功能
如需使用 Routes API 进行大型车辆路线规划，请按以下步骤操作：
- 设置云项目：确保已创建 Google Cloud 云项目并已为 Routes API 启用该项目。
- 为大型车辆路线规划功能预配项目：大型车辆路线规划功能仅向部分客户提供，请与我们联系以申请访问权限，并为您的项目预配此功能。
- 构建请求：调用
computeRoutes或computeRouteMatrix端点，将travelMode设置为TRUCK，将routingPreference设置为TRAFFIC_AWARE_OPTIMAL，并使用vehicleInfo对象指定车辆属性。 - 提供精细导航（可选）：如果您调用了
computeRoutes，请将响应中的routeToken传递给 Navigation SDK，以启动导航会话。