Routes API 的大型车辆路线规划 功能可计算大型车辆的路线和预计到达时间 (ETA)。它会返回经过优化的路线，这些路线会避开基于车辆高度、重量、长度和危险品分类的限制。该服务还会生成一个 路线令牌，该令牌可以传递给 Navigation SDK，以提供分步导航。
为何使用大型车辆路线规划功能
使用大型车辆路线规划功能构建应用，以解决大型车辆车队的物流挑战。
| 优势 | 说明 |
|---|---|
| 提高定价和规划的准确性 | 生成包含实时路况信息的具体 ETA，以便为卡车和公交车等大型车辆提供更准确的报价和送达时间范围。 |
| 提高驾驶员的安全性和效率 | 引导驾驶员沿路线行驶，避开低矮的桥梁、限重道路和其他危险。 |
| 简化整个车队运营 | 将 Route Optimization API 与大型车辆路线规划功能结合使用，优化整个车队的装载分配和停靠顺序。使用 Fleet Engine 实现作业和车辆位置的实时可见性。 |
| 最大限度地减少培训并提高采用率 | 让大型车辆或卡车驾驶员在您自己的应用中熟悉 Google 地图导航体验 |
大型车辆路线规划功能可实现哪些操作
借助大型车辆路线规划功能，您可以执行以下关键操作：
- 指定详细的车辆属性 ，包括高度、重量、长度、宽度、车轴数和危险品分类。
- 获取专门针对车辆属性计算的路线、行程时间和行程距离 。
- 生成针对机动性优化的路线 ，方法是自动避开掉头，并强烈偏好州际公路和高速公路。这样可确保大型车辆行驶的路线符合驾驶员的需求和期望。
- 使用卡车专用 ETA 模型计算更准确的 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 以启动导航会话。