Routes API 的大型车辆路线规划功能可计算大型车辆的路线和预计到达时间 (ETA)。它会根据车辆高度、重量、长度和危险材料分类，返回避开限制的优化路线。该服务还会生成一个路线令牌，该令牌可传递给 Navigation SDK，以提供精细导航。
为何使用大型车辆路线规划
使用大型车辆路线规划功能构建应用，为大型车辆车队解决物流难题。
| 优势 | 说明 |
|---|---|
| 提高定价和规划准确性 | 生成具体的、基于路况的预计到达时间，以便为卡车和公交车等大型车辆提供更准确的报价和送达时间范围。 |
| 提高驾驶员的安全性和效率 | 引导司机避开低矮桥梁、限重道路和其他危险路段。 |
| 简化整个舰队的操作 | 将 Route Optimization 与大型车辆路线规划搭配使用，可优化整个车队的负载分配和经停点顺序。使用 Fleet Engine 实时查看任务和车辆位置。 |
| 减少培训并提高采用率 | 在您自己的应用中为大型车辆或卡车司机提供熟悉的 Google 地图导航体验 |
大型车辆路线规划的功能
借助大型车辆路线规划，您可以执行以下关键操作：
- 指定详细的车辆属性，包括高度、重量、长度、宽度、车轴数量和危险品分类。
- 获取专门针对车辆属性计算的路线、行程时间和行程距离。
- 生成针对机动性进行优化的路线，自动避开 U 形弯道，并优先选择州际公路和高速公路。这样可以确保大型车辆在满足其驾驶员需求和期望的路线中行驶。
- 使用卡车专用 ETA 模型计算更准确的预计到达时间。该模型将观察到的卡车行驶速度与实时和预测交通数据相结合，为大型车辆提供更准确的估算。
- 使用路线令牌在 Navigation SDK 中启用精细导航，以从 Routes API 传输卡车安全路线。
- 计算路线矩阵，以确定多个出发地和目的地之间的行程时间和距离，从而进行车队范围的规划。
- 为您的卡车车队优化路线规划，在考虑可行性和安全性的前提下，提高整体运营效率。
大型车辆路线规划的工作原理
大型车辆路线规划功能通过以下服务实现：
| 端点 | 操作 | 输出 |
|---|---|---|
| Routes API | 向 Routes API 端点（computeRoutes 或 computeRouteMatrix）发送 HTTPS 请求，并在请求正文中包含起点和终点。travelMode 必须设置为 TRUCK，并且 routeModifiers 对象必须包含 vehicleInfo。
|
路线多段线、路线路段和步骤列表、预计行程时间以及路线令牌。 |
| Route Optimization API | 向 Route Optimization 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 会返回一条考虑了指定车辆信息的路线。 响应可以包含路线多段线、卡车专用预计到达时间、行驶距离和路线令牌，以便与 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，以启动导航会话。