Turf.js中booleanPointOnLine始终返回false问题求助

我需要检查用户点击的坐标是否位于LineString范围内，但使用Turf.js的boolean-point-on-line方法时，除了点坐标与LineString中的坐标完全一致的情况外，该方法始终返回false。

示例代码：

var line = {"type": "Feature","geometry": {"type": "LineString","coordinates": [[125.95258164431453,8.685291544847786],[125.95232752816695,8.685149645776638],[125.9519648088196,8.68522476398713],[125.9516401148043,8.685516506081687],[125.951592738644,8.685694826544953]]}}
var pt = {"type": "Feature","geometry": {"type": "Point","coordinates": [125.95233365893367,8.685152837740315]}}
turf.booleanPointOnLine(pt, line)

坐标对应结果：

问题原因及解决办法 #

booleanPointOnLine默认采用精确匹配，只有点完全落在线段的数学路径上才会返回true。但实际场景中，用户点击的坐标难免存在精度误差，或者只是在线段附近，这时候就需要通过设置**容差（tolerance）**来放宽判断条件。

修改后的代码 #

通过方法的第三个参数options设置容差值，允许点在线段的指定距离范围内时返回true：

var line = {"type": "Feature","geometry": {"type": "LineString","coordinates": [[125.95258164431453,8.685291544847786],[125.95232752816695,8.685149645776638],[125.9519648088196,8.68522476398713],[125.9516401148043,8.685516506081687],[125.951592738644,8.685694826544953]]}}
var pt = {"type": "Feature","geometry": {"type": "Point","coordinates": [125.95233365893367,8.685152837740315]}}

// 设置容差为0.00001度（约等于1米，可根据需求调整）
const result = turf.booleanPointOnLine(pt, line, { tolerance: 0.00001 })
console.log(result) // 此时会返回true

关键说明 #

• 容差的单位默认是地理坐标系的度，如果使用投影坐标系（如以米为单位），则直接输入对应的米数即可。
• 容差值的大小需根据实际场景调整：地图点击场景下，设置为1-5米对应的地理距离（约0.00001-0.00005度）较为合适。

内容的提问来源于stack exchange，提问作者Yuu