MySQL ST_LineInterpolatePoint 怎样定位折线上的比例位置

MySQL ST_LineInterpolatePoint(ls, fraction) 按折线从起点开始的累计长度比例返回一个 Point。fraction 取 0 到 1：0.5 表示沿折线走过总长度的一半，通常不是起终点坐标的简单平均，也不是取中间编号的顶点。先确定 LineString 的顶点顺序和坐标系，再传入比例，结果才与业务中的“完成百分比”一致。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/spatial-operator-functions.html

先明确比例定位保护的是哪种业务含义

考虑给一条线路标记百分比位置的场景。我会先问比例是路程比例、时间比例还是采样点比例。这个函数提供的是几何长度比例：如果路线各段行进速度不同，长度的 50% 就不能被当作耗时的 50%。这类语义误用比 SQL 写法本身更容易让结果偏离业务目标。

本文把输入与结果约束作为重点：路线来自哪个版本、顶点顺序是否正确、比例是否在范围内，都应成为明确的调用条件。这是数据正确性的约定，不是声称该函数自身存在某种已知漏洞。计算结果只表达沿输入折线的位置，也不会自动纠正道路拓扑、断点或不合理路线。

用一条折线理解累计长度比例

使用 SRID 0 的平面坐标示例：折线为 (0,0)、(6,0)、(6,8)，两段长度分别是 6 和 8，总长为 14。比例 0.5 对应累计长度 7，理论位置在第二段上，坐标为 (6,1)；起终点平均值 (3,4) 并不位于这条折线上。这些数值由简单几何推导得到，并非数据库运行回执。

-- 本例坐标是平面示意单位，不把 SRID 0 的数字称作米。
SET @route = ST_GeomFromText('LINESTRING(0 0,6 0,6 8)', 0);

-- 比例描述累计长度份额；同时查看类型与 SRID 便于解释结果。
SET @fraction = 0.5;
SELECT
    ST_GeometryType(@route) AS input_type,
    ST_SRID(@route) AS input_srid,
    ST_AsText(ST_LineInterpolatePoint(@route, @fraction)) AS position_wkt;

这里没有建表或写入生产数据。对真实表执行时，应先按路线主键或其他业务条件找到目标线路，再做定位；不要为了取单条线路的位置扫描所有几何记录。是否使用某个索引应结合实际查询条件判断，不把插值函数本身描述成索引加速手段。

把几何类型与比例约束放在入口

MySQL 8.4 文档要求几何参数为 LineString，比例在 [0.0,1.0]。其他几何类型或超范围比例会报错，NULL 参数则按该类函数的约定返回 NULL。输入在应用层应有明确的数值类型约束，不能让“50%”字符串或数值 50 被无意当成 0.5。

我的选择是对超范围输入返回参数错误，而不是默认把它夹到 0 或 1；静默修正会掩盖百分比单位混用。接口若确实采用容错夹取策略，应把规则写在协议里，并保留原始值。缺失路线、缺失比例和计算错误也要分别表达，不能都包装成一个看似正常的点。

-- 使用参数标记绑定几何与比例，不把外部文本拼进 SQL。
PREPARE locate_point FROM
    'SELECT ST_AsText(ST_LineInterpolatePoint(?, ?)) AS position_wkt';
SET @route_arg = ST_GeomFromText('LINESTRING(0 0,6 0,6 8)', 0);
SET @fraction_arg = 0.25;
EXECUTE locate_point USING @route_arg, @fraction_arg;
-- 用完释放预处理语句；应用程序也应处理执行错误与 NULL 结果。
DEALLOCATE PREPARE locate_point;

参数绑定解决 SQL 值传递问题，不替代几何质量控制。对外部上传的 WKT、WKB，应限制大小与复杂度，并确认解析成功、几何类型和业务允许的坐标系。零长度或其他退化路线建议由业务明确拒绝，避免“比例进度”缺乏可解释含义。此处没有承诺数据库对所有退化几何都返回同一种结果。

区别比例定位、顶点选择与定距定位

不要把单点插值与复数版本的接口机械互换；两者的结果类型与参数约定需要分别阅读。若已有的是“距离起点多少米”，优先确认空间参考系统和距离单位，再选择定距接口，而不是随意除以一个未经确认的长度。

文档说明单点插值支持笛卡尔与地理空间参考系统。支持地理坐标并不意味着可以拿经纬度坐标当平面坐标手算；真实地理数据应遵循其 SRS 的语义。仅改变 SRID 标记也不等于做了坐标变换。跨系统传递时，应将 SRID 与坐标一同保留。

记录方向、坐标系与结果精度

需要复现某个位置时，记录路线 ID、路线版本、原始比例和输入 SRID，比只保存一段 POINT 文本更有用。路线修改或顶点顺序反转后，相同的比例不一定对应原来的位置。显示时的小数位舍入也应与内部计算结果分开处理。

官方文档特别提示，fraction=1 时，近似数值计算可能产生一个非常接近末端而非完全等于末端的点。如果业务明确要求返回原始端点，可以在参数有效且几何合法的前提下，针对 0 和 1 分支使用 ST_StartPoint、ST_EndPoint。不要用格式化后的字符串相等来判断几何意义上的一致。

-- 端点身份必须精确保留时，显式选择原始端点。
-- 调用前应已确认 @fraction 在 0 到 1 之间且 @route 为合法折线。
SELECT ST_AsText(
    CASE
        WHEN @fraction = 0 THEN ST_StartPoint(@route)
        WHEN @fraction = 1 THEN ST_EndPoint(@route)
        ELSE ST_LineInterpolatePoint(@route, @fraction)
    END
) AS position_wkt;

为什么 0.5 没有落在中间顶点？因为顶点间距不一定相等；函数使用累计长度，不按顶点数量分配比例。

把折线方向反过来会怎样？比例从输入起点计量，方向变化会改变多数比例对应的位置。路线方向应属于数据契约的一部分。

能用于按时间播放轨迹吗？只有业务明确采用匀速几何进度时才能直接套用。含时间戳的真实轨迹需要单独建立时间与沿线位置的映射。

接口事实参考 MySQL 8.4 空间操作函数文档。