综述

路线计算采用的服务名称为 SE_RC，本文档在此后的示例采用此服务名称。接口 URL 符合此公式：[WEBNAME]/ [服务名称]? [参数名称]=[参数数值] [&[参数名称]=[参数数 值]]*。URL 编码采用的字符编码为 utf-8。 URL 示例：http://serviceaddress/SE_RC?st=RC&start=116.37007,39.97512&end=116.37016,39.97598
详细说明请参见：路径计算说明文档

RC

描述:

此服务为 SE_RC 的主服务，完成了 SE_RC 服务的大部分功能。

参数:

参数名称	含义	必有	默认	错误处理	备注
st	服务类型	是	无		其值可以是 RC、Nearest
start	起始点	是	无		参见经纬度说明
end	终止点	是	无		参见经纬度说明
output	输出模式	否	xml	使用默认值	支持 xml 和 json 的结果输出
callback	回调函数名	否	无		output=xml 时，该参数无效。 callback 输 出 结 果 示 例 , 假 设 callback=aaa： aaa&&aaa(json 的输出结果)
waypoint	途经点	否	无		最多可以设置 16 个途经点
cd	输入坐标的类型	否	gcj02	无	取值gcj02、wgs84
type	方案	否	1	使用默认值	0：最短 1：最快(默认) 2：最经济

经纬度说明：经纬度输入采用度为单位，为浮点数。经度与纬度之间使用空格分隔，点 与点之间采用分号分隔。例如： st=RC&start=115.28472,39.38593&end=115.28984,39.38183&type=1

示例:

(1)http://serviceaddress/SE_RC?st=RC&start=116.35622,39.93696&end=116.00111,40.36013
描述：起点为西直门，终点为八达岭。

(2)http://serviceaddress/SE_RC?st=RC&start=116.35622,39.93696&end=116.00111,40.36013&type=2
描述：起点为西直门，终点为八达岭最经济路线。

(3)http://serviceaddress/SE_RC?st=RC&start=116.34498,39.96101&end=113.26475,23.19688&way point=121.28641,31.11366
描述：从北京出发经上海到达广州。

输出：

XML输出

<?xml version="1.0" encoding="UTF-8"?> <xml> <!--查询结果状态--> <status>ok</status> <!--查询结果--> <result> <!--路线总长度--> <distance>10.2公里</distance> <time>6分钟</time><!--所需时间--> <events><!--事件集合--> <event><!--单个事件--> <roadname></roadname><!--道路名称--> <lng>116.35622</lng><!--经度--> <lat>39.93696</lat><!--纬度--> <nextdistance>28</nextdistance><!--到达下一个事件点的距离--> <reachtype>出发</reachtype><!--所需时间--> <turntype>车头正东</turntype><!--转向类型--> <roadlevel>城市快速路</roadlevel><!--道路等级--> <changename>没有改变</changename><!--改变类型--> <eventprompt>正东向出发,沿无名道路行驶28米</eventprompt><!--事件描述--> <realtraffic>缓慢</realtraffic><!--扩展，实时路况状态--> </event> <event> <roadname></roadname> <lng>116.35654</lng> <lat>39.93713</lat> <nextdistance>132</nextdistance> <reachtype>继续行驶</reachtype> <turntype>右转</turntype> <roadlevel>城市快速路</roadlevel> <changename>没有改变</changename> <eventprompt>右转,驶入无名道路,行驶132米</eventprompt> <realtraffic>缓慢</realtraffic> </event> …… <events> <route> <pointnum>62</pointnum><!--关键点个数 --> <routetxt> D5GxAEf/PAANkbEAdP88AA2RsQB0/zwAFpGxAID/PAAWkbEAgP88ABeRsQCK/zwAGJGxAJr/PAAYkbEAmv88ABeRsQCd /zwA </routetxt><!--关键点描述，为坐标的三十六进制文本--> </route> </result> </xml>

JSON输出：

{ "status":"ok", //状态 "result":{ "distance":"10.2 公里",//导航线路总长度 "time":"6 分钟",//导航线路大概花费时间 "events":[//事件集合 { "roadname":"西直门南大街", //道路名称 "lng":116.35622, //经度 "lat":39.93696, //纬度 "nextdistance":"92", //距离下一个事件的距离 "reachtype":"出发", //事件类型 "turntype":"车头正北", //转向类型 "roadlevel:"国道", //道路类型 "changename":"没有改变", //改变类型 "eventprompt":"正北向出发,沿西直门南大街行驶 92 米", //事件描述 "realtraffic":"缓慢" //实时路况状态 }, …… ] "route":{ //关键路径 "pointnum":"258", //关键点数 "routetxt":" D5GxAEf/PAANkbEAdP88AA2RsQB0/zwAFpGxAID/PAAWkbEAgP88ABeRsQCK/zwAGJGxAJr/PAAYkbEAmv88ABeRsQCd /zwA" //关键点描述 } } }

Nearest

描述:

此服务为最近点服务，即返回道路上距离指定点最近的点，用于导航纠偏。

参数:

参数名称	含义	必有	默认	错误处理	备注
st	服务类型	是	无		其值可以是 RC、Nearest
point	点坐标	是	无		经纬度输入采用度为单位，为浮点数。经度与纬度之间使用逗号分隔。
cd	输入坐标的类型	否	gcj02	无	取值gcj02、wgs84
course	偏移方向	否	有		行驶方向与正北方向的夹角，单位：1/10 度。 取值范围：0-3599 1800(自北向南) 0(自南向北)
output	输出模式	否	xml	使用默认值	支持 xml 和 json 的结果输出。
callback	回调函数名	否	无		output=xml 时，该参数无效。 callback 输 出 结 果 示 例 , 假 设 callback=aaa： aaa&&aaa(json 的输出结果)

示例：

(1)http://serviceaddress/SE_RC?st=Nearest&point=115.28472,39.38593
描述：查询道路上距离 115.28472,39.38593 最近的点。

输出：

XML输出

<?xml version="1.0" encoding="UTF-8"?> <xml> <status>ok</status> <!--查询结果状态--> <result> <!--查询结果--> <route> <!--线路--> <roadname>未知路线</roadname> <!--线路名称--> <lng>116.35622</lng> <!--计算到线路上最近的点的经度--> <lat>39.93696</lat> <!--计算到线路上最近的点的纬度--> <length>932</length> <!--米--> <roadtype>本线（上下线非分离）</roadtype> <!--道类型路 --> <roadlevel>国道</roadlevel> <!--道类级别 --> <lanewidth>[3米~5米]</lanewidth> <!--道路宽度--> <roadlimit>70</roadlimit> <!--限制速度，参考，非必须km/s--> <lanenumber>三车道</lanenumber> <!--道路车道数--> <distance>834</distance> <!--到达该线路的距离，单位：米--> <pointnum>16</pointnum> <!--道路关键点数--> <routetxt> 6xkm92dp7a6xklx2dp6q6xklc2dp5v6xkkv2dp556xkka2dp476xkjw2dp3n6xkjd2dp2v6xkiy2dp286xkib2dp1b6x khz2dp0s6xkhc2dozu6xkgy2doz86xkg62doy46xkff2dowz6xkea2dovd6xkdt2doup</routetxt> </routetxt> <!--道路关键点描述--> </route> </result> </xml>

JSON输出

{ "status":"ok", //查询结果状态 "result":{ //查询结果 "route":{ //道路信息 "roadname": "未知路段", //道路名称 "roadtype":"本线（上下线非分离）",//道路类型 "roadlevel":"国道", //道路级别 "length":"932", //道路长度 "lanenumber":"3", //道路车道数 "lanewidth":"20", //道路宽度 "roadlimit":"70", //道路限制速度 "lng":"116.2358", //距离查询点在道路上的最近点的经度 "lat":"39.34566", //距离查询点在道路上的最近点的维度 "distance":"834", //距离查询点在道路上的最近点的距离 "pointnum":"16", //道路的关键点数 "routetxt":"6xkm92dp7a6xklx2dp6q6xklc2dp5v6xkkv2dp556xkka2dp476xkjw2dp3n6xkjd2 dp2v6xkiy2dp286xkib2dp1b6xkhz2dp0s6xkhc2dozu6xkgy2doz86xkg62doy46xkff2dowz6xke a2dovd6xkdt2doup" //道路的关键点描述 } } }

错误输出：

XML输出

<?xml version="1.0" encoding="utf-8"?> <xml> <status>error</status> <!--返回状态值--> <error>参数出错</error> <!--错描述误--> </xml>

JSON输出

{ "status":"error", //返回状态值 "error":"参数出错" //错误描述 }