coordinatesearch接口
URL: |
http:// <BusServer-URL> / coordinatesearch |
父资源: |
BusServer |
[ 服务说明 ]
coordinatesearch 接口用于通过起点和终点的地理坐标查询公交出行方案。
[ 参数说明 ]
[ 请求接口参数 ]
| 参数 | 参数说明 |
|---|---|
| sx |
参数是否必须：否 参数含义：start 不能唯一确定站点时，sx 用于提供起始站点的经度 |
| sy |
参数是否必须：否 参数含义：start 不能唯一确定站点时，sy 用于提供起始站点的纬度 |
| ex |
参数是否必须：否 参数含义：end 不能唯一确定站点时，ex 用于提供终止站点的经度 |
| ey |
参数是否必须：否 参数含义：end 不能唯一确定站点时，ey 用于提供终止站点的纬度 |
| ditie |
参数是否必须：否 参数含义：布尔类型，表示是否乘坐地铁，默认为true（即乘坐地铁） |
| num |
参数是否必须：否 参数含义：表示返回方案的最大数目，可以不设，默认为5 |
[ 返回结果参数 ]
| 参数 | 参数说明 | ||||
| state | 参数含义：状态，true 表示成功，false 表示失败 | ||||
| describe | 参数含义：描述错误的原因 | ||||
| needmoreinfo | 参数含义：表明当前条件不足，需要更多的条件 | ||||
| startArray | name | 参数含义：与起点重名的站点名称 | |||
| geom | type | 参数含义：地理对象的类型 | |||
| coordinates | 参数含义：地理对象的空间坐标 | ||||
| endArray | name | 参数含义：与终点重名的站点名称 | |||
| geom | type | 参数含义：地理对象的类型 | |||
| coordinates | 参数含义：地理对象的空间坐标 | ||||
| total | 参数含义：实际返回方案的数目 | ||||
[ 示例 ]
coordinatesearch请求接口示例：
http://127.0.0.1:8099/newmap/rest/services/公交/changzhibus/BusServer/coordinatesearch?sx=113.128384&sy=36.217964&ex=113.138768&ey=36.219814&format=json
[ 返回结果 ]
coordinatesearch操作成功时的返回结果示例 ：
{"total":1,"state":true,"cases":[{"id":"1","transcount":0,"walkdis":2297,"walktime":2068,"totaltime":3389,"totaldis":5303,
"steps":[{"type":"walk","dis":914,"time":823,"first":"起点","last":"长治职业学院站","describe":"步行至长治职业学院站",
"route":"向东南方向走210米,右转,走390米,右转,沿捉马东大街走320米,到达长治职业学院","origin":{"type":"Point","coordinates":[113.1283213,36.21769685]},
"destination":{"type":"Point","coordinates":[113.1260488,36.21479189]},
"geom":{"type":"MultiLineString","coordinates":[[[113.1289319,36.21755358],[113.1283213,36.21769685]],[[113.1299902,36.21729797],[113.1289319,36.21755358]],[[113.130578,36.21715567],[113.130574,36.21715762],[113.1299955,36.21729643],
[113.1299902,36.21729797]],[[113.1297581,36.21492578],[113.1297658,36.21494556],[113.1299058,36.2153378],[113.1299955,36.21558175],[113.1301319,36.21595848],[113.1301618,36.21603028],[113.1301978,36.21612241],[113.1302557,36.21626711],
[113.1302932,36.21637013],[113.1303341,36.21648537],[113.13036,36.2165602],[113.1303917,36.21664456],[113.1304277,36.216746],[113.1304701,36.21686052],[113.1305179,36.21699211],[113.130578,36.21715567]],[[113.1297381,36.21486455],
[113.1297581,36.21492578]],[[113.12936,36.21383466],[113.1294351,36.21404198],[113.1297381,36.21486455]],[[113.1278081,36.21423562],[113.1290181,36.2139522],[113.12936,36.21383466]],[[113.1263957,36.21456605],[113.1276323,36.21427691],
[113.1278081,36.21423562]],[[113.1260161,36.21465545],[113.1260701,36.21464215],[113.1263957,36.21456605]],[[113.1260161,36.21465545],[113.1260488,36.21479189]]]}},
{"type":"bus","dis":3006,"time":1321,"first":"长治职业学院站","last":"赵凹站","describe":"乘坐902路(上行)经3站到赵凹站下车"...
}]}]}
coordinatesearch操作失败时的返回结果示例 ：
{
"state":false,"describe":"Missing 'start'Parameter"}
"state":false,"describe":"Missing 'start'Parameter"}