GraphHopper中使用MaxSpeedCalculator时的注意事项

问题背景

在使用GraphHopper进行路线规划时，开发者可能会遇到一个关于MaxSpeedCalculator的配置问题。当尝试使用MaxSpeedCalculator功能时，如果没有正确配置相关参数，程序会在运行一段时间后崩溃，而不是立即给出明确的错误提示。

问题现象

开发者在使用MaxSpeedCalculator时，可能会编写类似以下的代码：

val hopper = GraphHopper()
hopper.osmFile = "berlin-latest.osm.pbf"
hopper.graphHopperLocation = "cache"
hopper.setMaxSpeedCalculator(MaxSpeedCalculator(MaxSpeedCalculator.createLegalDefaultSpeeds()))
hopper.setEncodedValuesString("car_access, car_average_speed, max_speed")
hopper.setProfiles(Profile("car").setCustomModel(GHUtility.loadCustomModelFromJar("car.json")))
hopper.chPreparationHandler.setCHProfiles(CHProfile("car")))
hopper.importOrLoad()

这段代码运行后会抛出以下异常：

Exception in thread "main" java.lang.IllegalArgumentException
	at java.base/java.util.concurrent.ForkJoinPool.<init>(ForkJoinPool.java:2708)
	...

问题原因分析

这个问题的根本原因在于没有正确配置MaxSpeedCalculator所需的所有必要参数。MaxSpeedCalculator需要两个关键配置才能正常工作：

1. 国家信息编码：必须包含"country"编码值
2. 城市密度计算：必须通过setUrbanDensityCalculation方法设置城市密度参数

解决方案

要正确使用MaxSpeedCalculator，需要按照以下方式配置GraphHopper：

val hopper = GraphHopper()
hopper.osmFile = "berlin-latest.osm.pbf"
hopper.graphHopperLocation = "cache"
hopper.setMaxSpeedCalculator(MaxSpeedCalculator(MaxSpeedCalculator.createLegalDefaultSpeeds()))
// 添加country编码
hopper.setEncodedValuesString("car_access, car_average_speed, max_speed, country")
// 设置城市密度计算参数
hopper.setUrbanDensityCalculation(.0, .0, .0, .0, 8)
hopper.setProfiles(Profile("car").setCustomModel(GHUtility.loadCustomModelFromJar("car.json")))
hopper.chPreparationHandler.setCHProfiles(CHProfile("car")))
hopper.importOrLoad()

技术细节

1. 国家信息编码：MaxSpeedCalculator需要知道道路所在的国家/地区，因为不同国家有不同的法定限速标准。这就是为什么必须包含"country"编码值。

2. 城市密度计算：城市和乡村地区的限速标准通常不同。通过setUrbanDensityCalculation方法可以定义如何计算和区分城市密度区域。参数包括：

   • 四个阈值参数（这里示例中设为.0）
   • 线程数（示例中设为8）

最佳实践建议

1. 在使用MaxSpeedCalculator前，始终检查是否已经配置了所有必要参数
2. 考虑在应用程序启动时进行参数验证，而不是等到导入过程中才发现问题
3. 对于生产环境，建议封装GraphHopper的初始化过程，确保所有依赖配置都已正确设置

总结

GraphHopper的MaxSpeedCalculator是一个强大的功能，可以自动计算道路的最大限速。但要正确使用它，开发者必须确保配置了所有必要的参数，包括国家信息编码和城市密度计算设置。通过遵循上述解决方案和最佳实践，可以避免常见的配置错误，确保应用程序稳定运行。