Valhalla项目中历史交通数据加载问题解析与解决方案

概述

在使用Valhalla路由引擎时，历史交通数据（predicted/historic traffic data）的加载是一个常见但容易出错的功能点。本文将详细分析历史交通数据加载过程中的关键问题及其解决方案。

历史交通数据加载机制

Valhalla处理历史交通数据需要经过以下几个关键步骤：

1. 数据准备：历史交通数据需要以特定格式存储在CSV文件中，文件路径遵循Valhalla定义的目录结构（如/custom_files/traffic/0/003/014.csv）

2. 数据导入：通过valhalla_add_predicted_traffic工具将CSV格式的历史交通数据导入到图块(tiles)中

3. 服务启动：Valhalla服务启动时需要正确配置以识别包含历史交通数据的图块

常见问题分析

问题现象

用户在尝试加载历史交通数据时遇到以下典型现象：

• valhalla_add_predicted_traffic工具执行成功，无报错信息
• 服务重启后API查询结果未体现历史交通数据影响
• /locate端点返回结果中speeds.predicted标志仍为false

根本原因

经过分析，问题主要源于以下两个关键点：

1. 图块压缩包未更新：当Valhalla配置中使用tile_extract选项时，系统会优先读取压缩包形式的图块数据。如果用户在添加历史交通数据后未重新生成压缩包，服务将继续使用旧的、不含历史交通数据的图块。

2. 配置误解：mjolnir.traffic_extract配置项仅用于实时交通数据，与历史交通数据无关，相关警告信息容易误导用户。

解决方案

正确的工作流程

1. 确保历史交通数据CSV文件格式正确，包含有效的自由流速度(freeflow)和约束速度(constrained)值

2. 执行valhalla_add_predicted_traffic工具导入数据

3. 关键步骤：重新生成图块压缩包

   tar cf traffic.tar traffic/
   

4. 重启Valhalla服务

验证方法

1. 使用/locate端点并设置verbose=true参数，检查返回结果中的predicted_speeds字段

2. 确认路由请求使用了time_dependent_forward_a*算法（在服务日志中可见）

3. 对比不同时间点的路由结果，验证时间敏感性

技术细节补充

速度值含义

• 自由流速度(freeflow)：代表非高峰时段（通常为19:00至次日07:00）的预期速度
• 约束速度(constrained)：代表高峰时段（通常为07:00至19:00）的预期速度
• 预测速度(predicted speeds)：针对特定时间点的历史平均速度数据

零值处理

Valhalla能够正确处理零值速度：

• 自由流/约束速度设为零时，系统将不使用这些值
• 预测速度设为零时，将被视为有效值（但实际应用中应避免）

最佳实践建议

1. 在开发环境先使用未压缩的图块目录（tile_dir）进行测试，简化调试过程

2. 定期验证历史交通数据的完整性和准确性

3. 建立自动化流程确保图块压缩包与原始图块目录同步更新

4. 监控服务日志中的相关警告信息，但需正确区分不同配置项的影响

通过遵循上述指导和理解Valhalla处理历史交通数据的内部机制，开发者可以有效地实现基于时间敏感的路由功能。