步行/驾车规划API是一套以http形式提供的驾车查询检索接口，返回json格式的检索数据，可用于实现开发线路规划功能。

根据出发地和目的地的坐标，取得一条或者多条行车路径或者步行路径的文字描述、形状点和相关路径信息。

https://api.careland.com.cn/api/v2/navi/routeplan

post、get

请求参数

参数名称	是否必填	默认值	格式举例	说明
ak	是			用户key
params	是	json	json结构体示例	json结构体（见下表）
callback	否	json		jsonp回调的方法名，当输入中带有此参数，输出中包含callback信息，格式为callback(json串); 否则，输出中只有json数据。

请求参数

参数名称	描述		是否必填	格式
origin	x	起点经度说明：单位为千分之一秒或度	Y	double
	y	起点纬度	Y	double
	date	出发日期，默认为0 格式：20180605	N	int
	time	出发时间，默认为0 格式：分钟(小时*60+分钟+1) 0-不使用出发时间	N	int
destinations (array)，最多支持64个	x	经由地或目的地经度说明：单位为千分之一秒或度	Y	double
	y	经由地或目的地纬度说明：单位为千分之一秒或度	Y	double
	condition	到该点的规划方式，默认为0（使用主计算条件）	N	int
condition	plan	计算条件说明： 1-表示系统推荐（默认） 2-表示高速优先 16-表示最少收费 32-表示步行	N	int
	avoid	避免条件（尽量不走）说明(多个条件组合用\|计算)： 0-表示不避免（默认） 1-表示避免收费 2-表示避免渡轮 4-表示避免收费站	N	int
	forbid	禁止通行条件说明(多个条件组合用\|计算)： 0-表示不禁止（默认） 1-表示禁止高速 2-表示禁止轮渡 4-表示禁止收费站 8-表示禁止掉头 16-表示禁止高架 32-表示禁止施工封闭	N	int
avoidpoint (array)，最多支持200个	x	回避地经度说明：单位为千分之一秒或度	N	double
	y	回避地纬度说明：单位为千分之一秒或度	N	double
	uid	回避地UID 说明：未知uid传0	N	int
avoidfence (array)	回避围栏,支持100个避让区域，每个区域最多可有16个顶点，每个区域的最大面积是100平方公里。经度和纬度用"",""分隔，坐标点之间用";"分隔例:["x,y;x,y;x,y","x,y;x,y"]		N	string
vehicle	height	车高(单位米) 说明：默认为0	N	double
	width	车宽(单位米) 说明：默认为0	N	double
	weight	车总重(单位吨)说明：默认为0	N	double
	length	车长(单位米) 说明：默认为0	N	double
	load	车载重(单位吨) 说明：默认为0	N	double
	selfweight	车自身重(单位吨) 说明：默认为0	N	double
	axles	车轴数说明：默认为0	N	int
	licenseplatetype	车牌类型说明: 0-未知为蓝牌（默认） 4-蓝牌车 8-黄牌车	N	int
	licenseplate	车牌号（utf-8）	N	string
	type	车参数，车型取值： 0-小轿车（默认） 1-房车 2-危化品车 16777216-微型货车 33554432-轻型货车 67108864-中型货车 134217728-重型货车	N	int
inputopt	coordtype	坐标类型说明：单位为千分之一秒或度 0-凯立德坐标系（默认）1-WGS84坐标系 2-国家加密坐标系	N	int
	multi	是否计算多条路径说明： 0-不需要（默认） 1-需要	N	int
	ferryround	渡轮绕行距离（米）说明：默认60000	N	int
outputopt	coordtype	坐标类型说明： 0-凯立德坐标系（默认）,单位千分之一秒 2-国家加密坐标系，单位度	N	int
	restrict	是否输出路径上的限行信息（仅json返回格式支持） 0：不输出（默认） 1：输出	N	int
	safe	是否输出路径上的安全信息（仅json返回格式支持） 0：不输出（默认） 1：输出	N	int
	district	是否输出路径经过的区域信息（仅json返回格式支持） 0：不输出（默认） 1：输出	N	int

请求示例

https://api.careland.com.cn/api/v2/navi/routeplan?params={"origin":{"x":411402000,"y":81435200,"date":20190628,"time":481},"destinations":[{"x":411436200,"y":81428500}],"condition":{"plan":1,"avoid":2,"forbid":32},"vehicle":{"height":3.1,"width":3.2,"weight":27,"axles":2,"type":134217728,"licenseplatetype":8,"selfweight":10,"load":20,"weels":0,"seats":5,"licenseplate":"粤A12345"},"inputopt":{"multi":0,"ferryround":60000},"outputopt":{"coordtype":0}}&callback=callback&ak=<您的密匙>

返回结果示例

({
				"errorMessage": "成功",
		"routeInfo": [{
		"desc": "出发地到北环大道",
		"etatime": "1472",
		"tag": "推荐路线",
		"uidInfo": [{
		"uid": "10384984",
		"distance": "26",
		"cellid": "62632096",
		"shapepoint": "410817106,81363031;410816183,81362870",
		"rtistat": "0"
	}, {
		"uid": "16540983",
		"distance": "17",
		"cellid": "62632096",
		"shapepoint": "410816183,81362870;410815967,81362371",
		"rtistat": "0"
								},
						……………………
						{
		"uid": "306773",
		"distance": "45",
		"cellid": "62655137",
		"shapepoint": "410873721,81450241;410875293,81450524",
		"rtistat": "4"
					}],
		"trafficlight": "6",
		"routeindex": "0",
		"routeid": "2953701660",
		"avoidtrafficjam": "0",
		"totalDistance": "5077",
		"travelDesc": [{
		"point": "向西",
		"nextRoadType": "0",
		"nextRoadName": "出发地",
		"roadType": "0",
		"partDesc": "沿出发地向西行驶",
		"direction": "西",
		"travelType": "7",
		"x": "410817106",
	"y": "81363031",
		"partDistance": "0",
		"roadName": ""
		}, {
		"point": "向右",
		"nextRoadType": "8",
		"nextRoadName": "深南大道辅道",
		"roadType": "0",
		"partDesc": "向右转,进入深南大道辅道",
		"direction": "北",
		"travelType": "0",
		"x": "410816797",
		"y": "81364986",
		"partDistance": "253",
		"roadName": "出发地"
					},
				……………………
					{
		"point": "直行",
		"nextRoadType": "0",
		"nextRoadName": "北环大道",
		"partStartK": "81h984u2g",
		"roadType": "0",
		"partDesc": "目的地在右侧",
		"direction": "未知",
		"travelType": "7",
		"x": "410875293",
	"y": "81450524",
		"partDistance": "0",
		"roadName": ""
		}],
		"pointNum": "9",
		"feature": "0",
		"travelId": "1",
		"prefer": "1",
		"totalTime": "998"
		}],
	"count": "1",
	"errorCode": "0"
});

返回参数说明

参数名称				描述	格式
errorCode				错误码	int
errorMessage				错误信息	string
count				路径数	int
routeInfo （array）	desc			路径说明	string
	totalDistance			路径总距离	int
	totalTime			路径总距离	int
	prefer			规划方式	int
	travelId			行程序号	int
	routeindex			路径索引号	int
	routeid			路径ID	string
	trafficlight			红绿灯数	int
	feature			路径特征	int
	etatime			路径ETA时间	int
	avoidtrafficjam			是否躲避拥堵路径	int
	routebv			路径权重值	int
	tag			路径标签文本	string
	toll			路径收费值（分）	int

	travelDesc （array	partDistance		行程段距离	int
		x		行程点经度	double
		y		行程点纬度	double
		travelType		诱导类型	int
		roadName		道路名	string
		roadType		道路类型，说明见1.5	int
		nextRoadName		下一段道路名	string
		nextRoadType		下段道路类型，说明见1.5	int
		point		诱导方向	string
		direction		绝对方向	string
		partDesc		行程说明文本	string
		shapepoint		形状点格式：经度,纬度;经度,纬度	string
	uidInfo （array）	uid		String	int
		cellId		CellID	int
		district		DistraictOrder	int
		distance		UID长度值(米)	int
		rtistat		UID上路况状态说明见1.2	int
		carspeedlimit		小车限速值	int
		tkspeedlimit		货车限速值	int
		busspeedlimit		客车限速值	int
		shapepoint		UID的形状点格式：经度,纬度;经度,纬度	string
	resInfo （array）需要参数控制返回	uid		限行所在uid	int
		cellid		限行所在图幅ID	int
		distance		限行距出发地距离(米)	int
		len		限行长度	int
		x		限行坐标经度	double
		y		限行坐标纬度	double
		type		限行类型（包含多个）	int
		rule	id	限行规则ID	int
		rule	desc	限行规则描述	string
	districtinfo （array）需要参数控制返回	provid	省级ID		int
		provname	省级名称		string
		cityid	市级ID		int
		cityname	市级名称		string
	camerainfo （array）需要参数控制返回	id	电子眼ID		int
		type	电子眼类型说明见1.4		int
		x	坐标经度		double
		y	坐标纬度		double
		carspl	小车限速		int
		tkspl	货车限速		int
		distance	距起点距离（米）		int
	safetyinfo （array）需要参数控制返回	id	安全提示ID		int
		type	安全提示类型说明见1.3		int
		x	坐标经度		double
		y	坐标纬度		double
		spl	限速		int
		distance	距起点距离（米）		int
	sectioninfo （array）需要参数控制返回	id	区间测速ID		int
		type	区间测速类型说明见1.4		int
x		坐标经度		double
y		坐标纬度		double
endx		终点经度		double
endy		坐标纬度		double
len		区间长度（米）		int
carspl		小车限速		int
tkspl		货车限速		int
distance		距起点距离（米）		int

路况状态说明

状态值	状态说明
0	可能影响，未知
1	缓行
2	拥堵
3	封闭
4	通畅
5	非常拥堵

安全信息类型说明

状态值	状态说明
1001	向左急转弯
1002	向右急转弯
1003	反向转弯
1004	连续转弯
1005	村庄
1006	学校
1007	注意危险
1008	事故易发路段
1009	上陡坡
1010	下陡坡
1012	傍山危险
1013	注意横风
1014	易滑
1015	堤坝路
1016	无人看守轨道交叉口
1017	有人看守轨道交叉口
1018	驼峰桥
1019	连续下坡
1900	自动计算急弯
1026	避险车道
1011	注意落石
1020	渡口
1021	水坝
1030	汇合口
1031	汇合口标牌
1032	注意牲畜
1033	文字性警示标牌
1034	两侧变窄
1035	右侧变窄
1036	左侧变窄
1037	文字信息
1041	当心塌方
1038	涉水线
1039	黄方格
1040	车道变窄
1901	过水路面
1902	T形交叉
1903	注意行人
1904	慢行
1905	左右绕行
1906	左侧绕行
1907	右侧绕行
1908	禁止超车
1909	禁止鸣笛
1910	窄桥
1911	会车让行

道路类型说明

类型	说明
0	高速公路
1	市内高速
2	收费道路
3	国道
4	省道
5	快速道路
6	主干道
7	次干道
8	一般道路
9	窄道路
10	其它道路
11	规划道路
12	小区道路
13	轮渡线
14	火车线
15	人行道
16	城市支路
17	县道
18	乡道
19	村道