如何借助Google Maps API判断坐标是否位于折线（Polyline）上

Google Maps JavaScript API 并没有提供像多边形 containsLocation() 那样直接检测点是否在折线上的内置方法，但可以通过API的几何库工具函数结合自定义逻辑实现需求。

核心实现思路 #

利用API的 isLocationOnEdge() 函数，遍历折线的每一段线段进行检测：

• isLocationOnEdge() 原本用于判断点是否在多边形的边缘，但同样适用于单条线段的检测。
• 遍历折线路径中的所有相邻坐标对，将每对坐标构造成临时线段，调用该函数判断车辆坐标是否在这条线段的容忍范围内。

代码示例 #

// 检测点是否在指定折线上
function isPointOnPolyline(vehicleLatLng, polyline) {
  const path = polyline.getPath();
  // 遍历折线的每一段线段
  for (let i = 0; i < path.getLength() - 1; i++) {
    const startPoint = path.getAt(i);
    const endPoint = path.getAt(i + 1);
    // 构造临时线段用于检测
    const segment = new google.maps.Polyline({
      path: [startPoint, endPoint]
    });
    // tolerance为容忍距离（单位：米），根据拉力赛精度需求调整
    if (google.maps.geometry.poly.isLocationOnEdge(vehicleLatLng, segment, 10)) {
      return true;
    }
  }
  return false;
}

注意事项 #

• 必须加载Google Maps几何库：在API引入时添加 &libraries=geometry 参数，例如：

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry"></script>
  

• 合理设置容忍距离：由于GPS坐标存在误差，需要根据实际场景调整 tolerance 参数（示例中为10米），避免因微小偏差导致误判。

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