0.1.1 • Published 1 year ago
Point 坐标点类
| 字段 | 类型 | 描述 |
|---|
| lng | Number | 经度 |
| lat | Number | 纬度 |
Segment 路径线段类
| 字段 | 类型 | 描述 |
|---|
| p0 | Point | 起始点 |
| p1 | Point | 结束点 |
| length | Number | 路径线段长度（米） |
| distance | Number | p0点距离路径起始点的距离 |
| direction | Number | 路径朝向（弧度） |
| directionInDegree | Number | 路径朝向（角度） |
Route 路线类
| 字段 | 类型 | 描述 |
|---|
| points | Point | 折线点 |
| segments | Segment | 路径线段 |
| totalDistance | Number | 总长度(米) |
| maxLng / minLng | Number | 最大最小经度 |
| maxLat / minLat | Number | 最大最小纬度 | 、 |
| centerLng / centerLat | Number | 包围盒中心经纬度 |
| RADIUS | Number | 地球半径（包围盒做梯形正畸后近似） |
成员方法
correct 方法
const res = correct(point);
将输入点位纠偏到路线的最近点位，并返回纠偏后点位相关信息
入参
| 字段 | 类型 | 描述 |
|---|
| point | Point | 计算 point 点到当前路径的最近点位 |
返回值
返回值 res 为一个对象，其中各属性如下
| 字段 | 类型 | 描述 |
|-----|------|-----|
| point | Point | 最近点 |
| point.r | Number | 最近点在线段上的位置，范围 0~1。0 代表最近点位于 p0，1 代表最近点位于 p1, 0.5 代表位于线段中点 |
| point.lng / point.lat | Number | 最近点的经纬度 |
| point.distance | Number | 最近点距离线段 p0 点的距离（米） |
| segment | Segment | 最近点所在线段 |
| index | Number | 最近点所在线段在 segments 数组中的下标 |
| distance | Number | 最近点距离路径起始点的距离（米） |
pointAt 方法
const point = pointAt(distance)
查询沿路线行进指定距离后的所在点位，并返回点位相关信息
入参
| 字段 | 类型 | 描述 |
|---|
| distance | Number | 距离路径起始点的距离（米） |
返回值
| 字段 | 类型 | 描述 |
|---|
| point | Point | 查询结果所在点位 |
| point.lng / point.lat | Number | 所在点的经纬度 |
| point.distance | Number | 实际距离（限定 0~路径总长） |
| direction | Number | 所在点路径朝向（弧度） |
| directionInDegree | Number | 所在点路径朝向（角度） |