Routes API 的大型车辆路线规划 功能是一组服务，用于计算大型车辆的路线和预计到达时间 (ETA)。通过接受指定车辆属性（例如高度、重量、长度和危险品分类）的请求，它可以返回经过优化的路线，以避开相关限制。该服务还会生成一个 路线令牌，该令牌可以传递给 Navigation SDK，以便为司机提供沿卡车专用路线的精细导航。
为何使用大型车辆路线规划
使用大型车辆路线规划功能构建应用，以解决大型车辆车队的物流挑战。
| 优势 | 应用行为 |
|---|---|
| 提高定价和规划的准确性 | 生成包含实时路况信息的具体预计到达时间，以便为卡车和公交车等大型车辆提供更准确的报价和配送时间范围。 |
| 提高司机安全性和效率 | 引导司机沿路线行驶，避开低矮桥梁、限重道路和其他危险。 |
| 简化整个车队运营 | 将 Route Optimization API 与大型车辆路线规划功能结合使用，优化整个车队的装载分配和停靠顺序。使用 Fleet Engine 实现对分配和车辆位置的实时可见性。 |
| 最大限度地减少培训并提高采用率 | 让大型车辆或卡车司机在自己的应用中体验熟悉的 Google 地图导航体验 |
大型车辆路线规划的功能
借助大型车辆路线规划功能，您可以执行以下关键操作：
- 指定详细的车辆资料 ，包括高度、重量、长度、宽度、轴数和危险品分类。
- 使用 Google 全面的道路数据和路况模型，获取 专门针对车辆属性计算的路线、行程时间和行程距离 。
- 使用我们新的卡车专用预计到达时间模型计算更准确的预计到达时间 。该模型将观测到的卡车行驶速度与实时和预测路况数据相结合，为大型车辆提供更准确的预计到达时间。
- 使用路线令牌在 Navigation SDK 中启用精细导航 ，以便从 Routes API 传输卡车安全路线。
- 计算路线矩阵 ，以确定多个出发地和目的地之间的行程时间和距离，从而进行车队范围内的规划。
- 优化卡车车队的路线规划 ，以提高整体运营效率，同时考虑可行性和安全性
大型车辆路线规划的工作原理
大型车辆路线规划功能通过以下服务运行：
| 端点 | 操作 | 输出 |
|---|---|---|
| Routes API | 向 Routes API 端点（computeRoutes 或 computeRouteMatrix）发送 HTTPS 请求，请求正文包含您的出发地和目的地。travelMode 必须设置为 TRUCK，并且 routeModifiers 对象必须包含车辆资料。
|
路线多段线、路线段和步数列表、预计行程时间和路线令牌。 |
| Route Optimization API | 向 Route Optimization API 端点发送 HTTPS 请求。travelMode 必须设置为 TRUCK，并且 routeModifiers 对象必须包含车辆资料。routeModifiers 对象中的出行方式和车辆资料。 |
针对特定车辆资料设计的车队优化路线规划，以及每次行程的路线令牌。 |
| Navigation SDK | 在调用 setDestination 时，包含 路线令牌（使用大型车辆路线规划功能从 Routes API 或 Route Optimization API 生成）。 |
针对卡车定制的精细导航体验，并遵循原始 Routes API 或 Route Optimization API 请求中指定的车辆资料的路线。 |
示例
必需：您的请求必须将 travelMode 设置为 TRUCK，并使用车辆的具体尺寸和属性填充
vehicleInfo 对象。
例如，基本的 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
}
}
}
该服务会处理此请求，并返回考虑了指定车辆资料的路线。根据指定的字段掩码，响应可以包含路线折线、卡车专用预计到达时间、行程距离和用于 Navigation SDK 的路线令牌。响应还会指明是否无法找到完全合规的路线。
请求和响应内容
下表总结了您用于发出大型车辆路线规划请求的资源及其返回的数据。
| 请求内容 | 响应内容 | 返回格式 |
|---|---|---|
|
|
JSON |
限制
在开始之前，您必须了解以下限制和要求。
- 地理位置可用性：大型车辆路线规划功能仅在 美国本土 48 个州 提供。
- 大型车辆路线规划功能处于预览版阶段。司机不得仅依赖此 API 返回的路线来确保安全或合法。路线不保证适合车辆，并且遵循这些路线可能会使司机面临低矮桥梁或禁止大型车辆行驶的道路等危险。
- 尽力而为的路线 。在某些情况下，API 无法找到完全符合出行限制的路线。相反，它会返回“尽力而为”的路线，该路线可能仍会穿越限制区域。Routes API 响应会在
routeRestrictionsPartiallyIgnored字段中清楚地标记这些路线。 在这些情况下，请仔细规划路线，最好使用其他来源的数据。 请勿将标记的路线用作规划或导航的唯一事实来源。 - 不支持的功能：我们正在努力为这项产品添加更多功能，但大型车辆路线规划功能不支持以下功能：
- 卡车通行费价格
- 速度限制
- 放射性危险品的路线规划
- 用量限额： 所有请求均受标准每秒查询次数 (QPS) 限制的约束。
如何使用大型车辆路线规划
- 设置项目： 确保您的 Google Cloud 项目已创建并已启用 Routes API。
- 为大型车辆路线规划功能预配： 请与您的 Google 代表联系，以便为您的项目预配此受限预览版功能。
- 构建路线请求： 调用
computeRoutes端点，并将travelMode设置为TRUCK，并使用VehicleInfo对象指定虚拟车辆。 - 提供精细导航（可选）： 将响应中的
routeToken传递给 Navigation SDK 以启动导航会话。