3.1 功能介绍

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

该套API免费对外开放,使用之前请先登录然后申请密钥获取使用该组API的key。

步行/驾车/货车路径规划:根据出发地和目的地的坐标,取得一条或者多条驾车路经、步行路径、货车路径的文字描述和形状点。

公交路径规划:可根据出发地和目的地的坐标,搜索公交换乘方案,最多可返回10条换乘方案。

3.2 使用限制

企业开发者:单个key支持20万次/天,1万次/分钟调用。

个人开发者:单个key支持1000次/天,1000次/分钟调用。

3.3 步行/驾车/货车路径规划

服务地址:http://api.careland.com.cn/api/v1/navi/routeplan?param

param代表的参数包括必填参数和可选参数,所有参数均使用(&)进行分隔。各参数的使用说明请参照下表。

请求参数:

参数名称是否必填默认值格式举例说明
ak 用户key
xytype 0 坐标类型:
0为凯立德坐标系
2为国家加密坐标系
origin 410817199,81362500 出发地坐标,经纬度之间用","分隔
destination 410875461,81449596 目的地坐标,经纬度之间用","分隔,destination可以是多对坐标,其顺序决定了规划路径的到达顺序,多对坐标用";"分隔
direction 当前车标方向角(正东),取值范围0-359度,-1时不使用方向。
evadesites 回避地的信息,用","分隔的各个信息项,evadesites可以使多对回避地,用";"分隔,回避地信息格式如:经度,纬度;经度,纬度
prefer 1 perfer=1-2-16 参数,1表示系统推荐,2表示高速优先,8表示最短距离,16表示最少收费,32表示步行。默认为1,多个条件组合用"-"号间隔,最多支持4个。
multi 0 是否计算多条线路返回,0 表示不需要,1表示需要多条返回,默认为0。
evade 回避条件参数,1表示回避高速,2表示回避轮渡,4表示回避收费站,8表示回避掉头,16表示回避高架,32表示回避施工封闭,多个条件组合用"-",多个条件组合用"-"号间隔。(设置了一定不走)
avoid 避免条件参数,1表示避免收费,2表示避免渡轮,4表示避免收费站,8表示避免掉头,16表示避免拥堵,多个条件组合用"-"号间隔。(设置了尽量不走)
frd 渡轮绕行距离参数,单位米。
isrtistat 0 0:无路况状态(默认)
1:有路况状态
wp 想要经过的uid。用"+"分隔的各个信息项,wp可以使多对UID信息,用"-"分隔,UID信息格式如:uid+cellid
wrn 想要经过的道路名(中文为utf8格式)。如果wp参数有效的话,此参数则无效
tht 货车参数,车高(取值范围0.1~5,单位米),不限制高度时为0。
twh 货车参数,车宽(取值范围0.1~5,单位米),不限制宽度时为0。
twt 货车参数,车重(取值范围0.1~160,单位吨),不限制重量时为0。
tad 货车参数,车轴重(取值范围0.1~60,单位吨),不限制轴重时为0。
tvt 货车参数,车型。
tlnt 货车参数,车牌类型。
tvtid 货车参数,用户自定义车型ID。
tcid 货车参数,车所在公司ID。
tflag 货车参数,货车参数参与路径计算标识,1表示车重不参与路径计算。
datatype 数据类型参数,0 表示全部(默认取除1外的全部类型),1表示详细原始推荐路径,2表示详细Link序列及属性(包括形状点(推荐路径显示、定位)),3 表示诱导点序列,4 表示行程说明信息数据,5 表示节点坐标序列 ,6 图幅ID序列,7沿路电子眼,8表示安全信,9表示货运专项数据,10表示沿路实时路况数据,11 表示路径属性数据,12表示区间测速数据,多个条件组合用"-"间隔。(二进制参数)
id 路径号,从1开始。当前同一个请求条件能获取多条路径时,该参数用于标识只获取指定序号的路径,默认全部
resop 0

是否输出限行信息

1:输出

0:不输出

output json json 输出格式为json或者xml(目前暂不支持xml)
callback 回调函数
callback值是用户定义的函数名称,此参数只在output=json时有效

请求示例:

http://api.careland.com.cn/api/v1/navi/routeplan?origin=410817199,81362500&destination=410875461,81449596&prefer=1-2-16&evade=32&avoid=2&callback=callback&ak=<您的密匙>

返回参数说明:

名称 类型 说明
errorCode String 错误代码
errorMessage String 错误描述
count String 返回的结果数
routeInfo Object[] 结果详细
  desc String 路径说明
totalDistance String 路径总距离
totalTime String 路径总时间
pointNum String 路径行程点数
prefer String 规划方式( 1-系统推荐; 2-高速优先; 8-最短距离; 16-最少收费; 32-步行)
travelId String 行程序号
routeindex String 路径序号
routeid String 路径id
trafficlight String 红绿灯个数
feature String 路径特征
etatime String ETA时间
avoidtrafficjam String 是否使用躲避拥堵
tag String 标签文本
travelDesc Object[] 行程说明
  partDistance String 行程段距离
partStart String 行程段起点
partStartK String 行程段起点K码
travelType String 行程诱导点类型
roadName String 道路名
roadType String 道路类型(0 一般道路1 隧道2 桥梁3 高架路4 下沉道路5 汽车轮渡线6 高速公路 7 快速道路8 辅道)
nextRoadName String 下一段道路名
nextRoadType String 下一段道路类型
point String 指向
direction String 方向
partDesc String 行程段说明
partPoints String[] 行程段形状点
uidInfo Object[] 行程经过的uid信息
  uid String 行程经过的UID(道路ID)
cellId String UID所在的图幅ID
distance String 行程经过的UID的距离
shapepoint String UID的形状点
rtistat String 路况状态
resinfo Object[] 限行信息
  uid String 限行的起点UID
cellid String 限行的起点UID 所在图幅
type String

限行的类型(十进制数值,需转换为由二进制位标识表示的类型。例如值为10 表示由2和8求或得到,即为限重和车种限制。以下为对应类型的二进制位为1时的十进制数值)

1 检查站【二进制:1】

2 限重【二进制:10】

4 施工封闭【二进制:100】

8 车种限制【二进制:1000】

128 限高【二进制:10000000】

256 限宽【二进制:100000000】

3.4 公交路径规划

服务地址:http://api.careland.com.cn/api/v1/navi/bustransfer?param

param代表的参数包括必填参数和可选参数,所有参数均使用(&)进行分隔。各参数的使用说明请参照下表。

请求参数:

参数名称是否必填默认值格式举例说明
ak 用户key
xytype 0 坐标类型:
0为凯立德坐标系
2为国家加密坐标系
origin 410094635,81764003 出发地坐标,经纬度之间用","分隔
destination 411075136,81382912 目的地坐标,经纬度之间用","分隔
transport 0 交通工具,0:全部;1:公交;2:地铁
prefer 换乘方案偏好,0:少换乘;1:时间短;2:少步行;3:推荐;4:地铁优先
solutionId 方案序号,从1开始。该参数用于标识只获取指定序号的路径,默认全部
startTime 出发时间,单位:分钟,如7:30,则计算规则为:7*60+30=450
solutionChoose 是否获取所有方案,0:获取当前时间可行方案; 1:获取所有方案(包括已停运)
output json json 输出格式为json或者xml(目前暂不支持xml)
callback 回调函数
callback值是用户定义的函数名称,此参数只在output=json时有效

请求示例:

http://api.careland.com.cn/api/v1/navi/bustransfer?origin=410094635,81764003&destination=411075136,81382912&transport=0&prefer=3&startTime=450&callback=callback&ak=<您的密匙>

返回参数说明:

名称 类型 说明
errorCode String 错误代码
errorMessage String 错误描述
count String 返回的结果数
planInfo Object[] 换乘方案
  planName String 换乘方案名称
startDistance String 起点换乘距离
endDistance String 终点换乘距离
segment String 换乘段数(1表示直达,依次类推)
walkDistance String 换乘段之间的步行距离,个数等于segment -1
planID String 换乘方案序号
origin String 出发地坐标
destination String 目的地坐标
originName String 出发地名称
destinationName String 目的地名称
lineLable String 方案标签,最快,换乘少,或者两组合,以”;”分隔
walkShapes String[] 步行段形状点,多段以“,”分隔
walkTimes String[] 步行段形状点对应时间,单位:分钟
lineInfo Object[] 线路详细
  lineName String 线路名称
lineType String 线路类型,1公交 2地铁
lineId String 线路ID
stationNum String 经过的站台个数
distance String 总距离(米)
startStationId String 上车站点ID
startStationK String 上车站点K码
startStationXY String 上车站点坐标
startStationName String 上车站点名称
endStationId String 下车站点ID
endStationK String 下车站点K码
endStationXY String 下车站点坐标
endStationName String 下车站点名称
time String 换乘时间(分)
shapes String[] 换乘段形状点(坐标对)
otherPaths Object[] 其他线路,如果有多条线路
  otherLineId String 线路id
otherLineName String 线路名称
otherLineType String 线路类型 1:公交; 2:地铁
stationInfo Object[] 途径站点信息
  stationId String 途径站点ID
stationName String 途径站点名称
stationXY String 途径站点坐标
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号