路径导航
优质
小牛编辑
119浏览
2023-12-01
路径导航分析服务可根据分析所需的起点、经过点、终点生成一条导航路径。支持距离最短、不走高速、推荐模式三种导航模式。
使用服务前需要先申请 key。
资源接口参数说明
路径导航分析服务支持GET和HEAD请求，支持json\xml\jsonp等格式调用。
GET 请求参数
| 参数名 | 类型 | 默认值 | 范例 | 是否必须 | 描述 |
|---|---|---|---|---|---|
| startPoint | Point2D | 无 | {"x":116.4,"y":39.9} | 是 | 导航分析的起点 |
| endPoint | Point2D | 无 | {"x":118.4,"y":42.9} | 是 | 导航分析的终点 |
| passPoints | Array<Point2D> | 无 | [{"x":117.4,"y":40.9}] | 否 | 导航分析的中间点 |
| routeType | String | MINLENGTH | MINLENGTH | 否 | 导航分析模式。枚举值：MINLENGTH、NOHIGHWAY、RECOMMEND，分别代表：距离最短、不走高速、推荐模式。 |
| returnPathInfos | boolean | true | true | 否 | 是否返回路径导引信息 |
| returnPathPoints | boolean | true | true | 否 | 是否返回导航路径 |
| to | int | 910101 | 910101 | 否 | 输出结果坐标类型。枚举值：910101、910111、910102、910112、910113。坐标类型编码参考坐标类型。 |
GET 请求响应结构
| 字段 | 类型 | 含义 |
|---|---|---|
| pathPoints | Point2D[] | 返回分析结果的点集合 |
| pathInfos | PathInfo[] | 返回分析结果的引导信息集合 |
| pathLength | double | 返回分析结果的总长度 |
| pathTime | double | 导航花费时间。单位：秒。 |
PathInfo 导航引导信息类接口说明如下：
| 字段 | 类型 | 含义 |
|---|---|---|
| dirToSwerve | int | 下一条道路的转弯方向。0代表直行，1代表左前转弯，2代表右前转弯，3代表左转弯，4代表右转弯，5代表走后转弯，6代表右后转弯，7代表掉头，8代表右转弯绕行至左，9代表直角斜边右转弯，10代表环岛。 |
| junction | Point2D | 下一条道路的路口点坐标 |
| length | double | 当前道路的长度 |
| routeName | String | 当前道路的名称 |
服务示例
导航路径分析服务支持一次分析单条路径和一次分析多条路径。以json格式输出为例，单条导航路径分析http请求如：
https://www.supermapol.com/iserver/services/navigation/rest/navigationanalyst/China/
pathanalystresults.json?pathAnalystParameters=[{startPoint:{"x":116.467524,"y":39.914319},
endPoint:{"x":116.25814,"y":40.666082},passPoints:[{"x":116.441454,"y":39.947892}],
routeType:MINLENGTH,to:910101}]&key=fvV2osxwuZWlY0wJb8FEb2i5多条路径分析http请求如：
https://www.supermapol.com/iserver/services/navigation/rest/navigationanalyst/China/
pathanalystresults.json?pathAnalystParameters=[{startPoint:{"x":116.467524,"y":39.914319},
endPoint:{"x":116.25814,"y":40.666082},passPoints:[{"x":116.441454,"y":39.947892}],
routeType:MINLENGTH,to:910101},{startPoint:{"x":115.437524,"y":39.714319},
endPoint:{"x":116.35814,"y":41.666082},passPoints:[{"x":115.441454,"y":38.947892}],
routeType:NOHIGHWAY},{startPoint:{"x":115.437524,"y":39.714319},endPoint:{"x":116.35814,"y":41.666082},
routeType:RECOMMEND,to:910101}]&key=fvV2osxwuZWlY0wJb8FEb2i5分析结果为数组形式，数组中的结果路径的顺序对应于发送请求时请求路径的顺序。
| 参数名 | 值 | 备注 |
|---|---|---|
| startPoint | {"x":116.467524,"y":39.914319} | 导航分析的起点 |
| endPoint | {"x":116.25814,"y":40.666082} | 导航分析的终点 |
| passPoints | [{"x":116.441454,"y":39.947892}] | 导航分析的中间点 |
| routeType | MINLENGTH | 三种导航模式：距离最短；不走高速；推荐模式 |
响应结果
[{
"pathInfos": [
{
"dirToSwerve": 3,
"junction": {
"x": 116.4687,
"y": 39.91533
},
"length": 118.83776705467744,
"routeName": ""
},详细结果：https://www.xnip.cn/wp-content/uploads/2021/docimg30/res1.txt