阿里云市场-高德-路径规划

第三方服务商
价格:免费使用  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

公交路径规划


接口地址:http://route.showapi.com/1997-4 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。 
文件上传的POST时,enctype=multipart/form-data。 

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起 

参数名称类型默认值示例值必须描述
cityString 昆明城市/跨城规划时的起点城市 目前支持市内公交换乘/跨城公交的起点城市。 可选值:城市名称/citycode
citydString  跨城公交规划时的终点城市 跨城公交规划必填参数。 可选值:城市名称/citycode
dateString  出发日期 根据出发时间和日期筛选可乘坐的公交路线,格式:date=2014-3-19
destinationString 102.7221,25.0149目的地 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
originString 102.8622,24.8658出发点。规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
strategyString  公交换乘策略 可选值: 0:最快捷模式 1:最经济模式 2:最少换乘模式 3:最少步行模式 5:不乘地铁模式
timeString  出发时间 根据出发时间和日期筛选可乘坐的公交路线,格式:time=22:34
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1997-4","my_appId","my_appSecret") .addTextPara("city","昆明") .addTextPara("cityd","") .addTextPara("date","") .addTextPara("destination","102.7221,25.0149") .addTextPara("origin","102.8622,24.8658") .addTextPara("strategy","") .addTextPara("time","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口 
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
 
showapi_res_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
status String1返回状态 值为0或1 1:成功;0:失败
info StringOKstatus为0时,info返回错误原;否则返回“OK”。详情参阅info状态表
infocode String10000详情参阅info状态表
count String3公交换乘方案数目
route Object 公交换乘信息列表
-  origin String116.481028,39.989643起点坐标
-  destination String116.434446,39.90816终点坐标
-  distance String14248起点和终点的步行距离 单位:米
-  taxi_cost String38.8704出租车费用 单位:元
-  transits Object[] 公交换乘方案列表
-  0 Object 公交换乘方案
-  cost String3.0此换乘方案价格 单位:元
-  duration String3562此换乘方案预期时间 单位:秒
-  nightflag String0是否是夜班车 0:非夜班车;1:夜班车
-  walking_distance String1281此方案总步行距离 单位:米
-  distance String13759每段线路步行距离
-  missed String0 
-  segments Object[] 换乘路段列表
-  0 Object  
-  taxi String[][] 
-  walking Object 此路段步行导航信息
-  origin String116.481003,39.989311起点坐标
-  destination String116.481987,39.983784终点坐标
-  distance String852每段线路步行距离
-  duration String730步行预计时间
-  steps Object[] 步行路段列表
-  0 Object  
-  instruction String步行13米左转此段路的行走介绍
-  road String[][]路的名字
-  distance String13此段路的距离
-  duration String[][]此段路预计消耗时间
-  polyline String116.481003,39.989311;116.480957,39.989269;116.480904,39.989220此段路的坐标
-  action String左转步行主要动作
-  assistant_action String[][]步行辅助动作
-  bus Object 此路段公交导航信息
-  buslines Object[] 步行路段列表
-  0 Object  
-  departure_stop Object 此段起乘站信息
-  name String西八间房站点名字
-  id String110100013750005站点id
-  location String116.481979,39.983788站点经纬度
-  arrival_stop Object 此段下车站 格式如:中关村
-  name String北京站东站点名字
-  id String110100013750022站点id
-  location String116.434982,39.905178站点经纬度
-  name String403路(环行铁道--北京站东)公交路线名称
-  id String110100013750公交路线id
-  type String普通公交线路公交类型
-  distance String12478公交行驶距离
-  duration String2464公交预计行驶时间
-  polyline String116.481979,39.983788;116.481979,39.983784;116.481232,39.983082;116.480728,39.982639;116.479652,39.981663;116.478661,39.980789;116.478088,39.980267;116.478020,39.980198;116.477974,39.980160;116.477692,39.979881;116.477203,39.979431;116.476852,39.979111;116.476715,39.978992;116.476250,39.978569;116.476044,39.978386;116.475029,39.977474;116.474304,39.976814;116.473869,39.976425;116.473488,39.976070;116.473488,39.976067;116.473282,39.975887;116.472763,39.975426;116.472382,39.975113;116.471313,39.974144;116.469719,39.972679;116.469078,39.972118;116.468285,39.971397;116.466522,39.969795;116.465218,39.968616;116.464951,39.968369;116.463608,39.967155;116.463608,39.967152;116.462814,39.966431;116.462753,39.966377;116.461693,39.965412;116.460800,39.964592;116.460396,39.964237;116.460396,39.964233;116.460121,39.963974;116.459991,39.963860;116.459412,39.963337;116.458458,39.962479;116.458084,39.962132;116.457916,39.961983;116.457359,39.961472;116.457306,39.961422;116.456886,39.961063;116.456650,39.960876;116.456039,39.960464;116.455711,39.960289;116.455536,39.960209;116.454758,39.959835;116.454430,39.959644;116.454178,39.959438;116.452232,39.957672;116.452011,39.957626;116.451942,39.957619;116.451820,39.957630;116.451752,39.957661;116.451714,39.957699;116.451683,39.957748;116.451683,39.957787;116.451683,39.957817;116.451698,39.957859;116.451996,39.958145;116.452545,39.958633;116.452637,39.958664;116.452705,39.958668;116.452988,39.958641;116.453476,39.958328;116.454079,39.957935;116.454910,39.957390;116.455292,39.957123;116.455574,39.956852;116.455711,39.956722;116.455956,39.956532;116.456146,39.956383;116.456627,39.956043;116.457222,39.955643;116.457916,39.955193;116.458107,39.955059;116.458160,39.955017;116.458717,39.954659;116.459427,39.954201;116.459229,39.954124;116.459129,39.954067;116.459045,39.954010;116.458923,39.953888;116.458504,39.953533;116.458076,39.953144;116.457893,39.952972;116.457634,39.952744;116.457436,39.952560;116.457275,39.952423;116.456879,39.952053;116.456177,39.951424;116.455605,39.950909;116.455521,39.950829;116.455482,39.950760;116.455444,39.950680;116.455429,39.950474;116.455429,39.950325;116.455429,39.950096;116.455437,39.949604;116.455437,39.949440;116.455437,39.949436;116.455444,39.949112;116.455452,39.948429;116.454216,39.948242;116.453941,39.948204;116.452232,39.947952;116.451874,39.947895;116.451302,39.947800;116.450310,39.947651;116.450188,39.947552;116.450264,39.947430;116.450294,39.947323;116.450348,39.947128;116.450363,39.946930;116.450378,39.946678;116.450378,39.946453;116.450378,39.945892;116.450363,39.945690;116.450363,39.944378;116.450363,39.944096;116.450363,39.944092;116.450363,39.942520;116.450348,39.941284;116.450348,39.941185;116.450363,39.940342;116.450363,39.940159;116.450363,39.940155;116.450378,39.939892;116.450394,39.939823;116.450417,39.939243;116.450401,39.938435;116.450409,39.937840;116.450409,39.937050;116.450394,39.936646;116.450394,39.936588;116.450378,39.936207;116.450378,39.935547;116.450363,39.934643;116.450317,39.933769;116.450310,39.933613;116.450310,39.933025;116.450294,39.932671;116.450294,39.931282;116.450294,39.930984;116.450294,39.930698;116.450294,39.929718;116.450294,39.927937;116.450294,39.927547;116.450294,39.927544;116.450287,39.926975;116.450287,39.924904;116.450287,39.924351;116.450287,39.924202;116.450287,39.923122;116.450287,39.922943;116.450279,39.922825;116.450279,39.921940;116.450279,39.920994;116.450294,39.920437;116.450294,39.918690;116.450294,39.918415;116.450294,39.918411;116.450294,39.917961;116.450287,39.917740;116.450287,39.916817;116.450287,39.916740;116.450287,39.916435;116.450287,39.916050;116.450287,39.915661;116.450279,39.915215;116.450287,39.914852;116.450279,39.914471;116.450279,39.914150;116.450279,39.913399;116.450272,39.912483;116.450264,39.912354;116.450264,39.911530;116.450264,39.911026;116.450264,39.910484;116.450264,39.910309;116.450264,39.910294;116.450264,39.909588;116.450119,39.909588;116.450104,39.909401;116.450119,39.908886;116.450241,39.908669;116.450241,39.908539;116.449585,39.908546;116.447639,39.908546;116.447571,39.908546;116.446960,39.908554;116.445969,39.908550;116.444725,39.908562;116.444534,39.908569;116.443886,39.908581;116.443802,39.908581;116.442879,39.908581;116.441017,39.908588;116.440971,39.908588;116.439529,39.908604;116.438576,39.908611;116.436699,39.908607;116.436073,39.908611;116.435730,39.908619;116.435402,39.908630;116.435341,39.908665;116.435310,39.908695;116.435272,39.908714;116.435219,39.908768;116.435173,39.908825;116.435158,39.908924;116.435158,39.909172;116.435143,39.909443;116.435143,39.909710;116.435150,39.909798;116.435165,39.909870;116.435211,39.909935;116.435280,39.909966;116.435349,39.909977;116.435432,39.909969;116.435532,39.909916;116.435646,39.909752;116.435730,39.907696;116.435745,39.907406;116.435799,39.906498;116.435837,39.906208;116.435837,39.906105;116.435844,39.905937;116.435867,39.905743;116.435867,39.905689;116.435905,39.905548;116.435867,39.905437;116.435844,39.905376;116.435799,39.905327;116.435745,39.905285;116.435692,39.905251;116.435608,39.905220;116.435486,39.905197;116.435394,39.905182;116.434982,39.905178此路段坐标集
-  start_time String0505首班车时间
-  end_time String2305末班车时间
-  via_num String17此段途经公交站数
-  via_stops Object[] 此段途经公交站点列表
-  0 Object  
-  name String京顺路丽都饭店途径公交站点信息
-  id String110100013750006公交站点编号
-  location String116.476250,39.978569公交站点经纬度
-  entrance String[][]地铁入口 只在地铁路段有值
-  exit String[][]exit 地铁出口 只在地铁路段有值
-  railway Object 乘坐火车的信息 详情见只在地铁路段有值
-  spaces String[][]仓位及价格信息
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "0be6aeb5487544a6aada69de877bc650", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "info": "OK", "infocode": "10000", "count": "3", "route": { "origin": "116.481028,39.989643", "destination": "116.434446,39.90816", "distance": "14248", "taxi_cost": "38.8704", "transits": [ { "cost": "3.0", "duration": "3562", "nightflag": "0", "walking_distance": "1281", "distance": "13759", "missed": "0", "segments": [ { "taxi": [], "walking": { "origin": "116.481003,39.989311", "destination": "116.481987,39.983784", "distance": "852", "duration": "730", "steps": [ { "instruction": "步行13米左转", "road": [], "distance": "13", "duration": [], "polyline": "116.481003,39.989311;116.480957,39.989269;116.480904,39.989220", "action": "左转", "assistant_action": [] }, { "instruction": "沿阜荣街步行300米右转", "road": "阜荣街", "distance": "300", "duration": [], "polyline": "116.480904,39.989216;116.481430,39.988880;116.481468,39.988857;116.483414,39.987583;116.483467,39.987404", "action": "右转", "assistant_action": [] }, { "instruction": "沿望京东路步行309米左转", "road": "望京东路", "distance": "309", "duration": [], "polyline": "116.483467,39.987400;116.483421,39.987358;116.482025,39.986088;116.481346,39.985485;116.481293,39.985435;116.481148,39.985275", "action": "左转", "assistant_action": [] }, { "instruction": "沿广顺南大街步行162米右转", "road": "广顺南大街", "distance": "162", "duration": [], "polyline": "116.481148,39.985268;116.481247,39.985203;116.481270,39.985092;116.482162,39.984493;116.482498,39.984257", "action": "右转", "assistant_action": [] }, { "instruction": "沿京密路步行68米到达西八间房", "road": "京密路", "distance": "68", "duration": [], "polyline": "116.482498,39.984253;116.481987,39.983784", "action": [], "assistant_action": "到达西八间房" } ] }, "bus": { "buslines": [ { "departure_stop": { "name": "西八间房", "id": "110100013750005", "location": "116.481979,39.983788" }, "arrival_stop": { "name": "北京站东", "id": "110100013750022", "location": "116.434982,39.905178" }, "name": "403路(环行铁道--北京站东)", "id": "110100013750", "type": "普通公交线路", "distance": "12478", "duration": "2464", "polyline": "116.481979,39.983788;116.481979,39.983784;116.481232,39.983082;116.480728,39.982639;116.479652,39.981663;116.478661,39.980789;116.478088,39.980267;116.478020,39.980198;116.477974,39.980160;116.477692,39.979881;116.477203,39.979431;116.476852,39.979111;116.476715,39.978992;116.476250,39.978569;116.476044,39.978386;116.475029,39.977474;116.474304,39.976814;116.473869,39.976425;116.473488,39.976070;116.473488,39.976067;116.473282,39.975887;116.472763,39.975426;116.472382,39.975113;116.471313,39.974144;116.469719,39.972679;116.469078,39.972118;116.468285,39.971397;116.466522,39.969795;116.465218,39.968616;116.464951,39.968369;116.463608,39.967155;116.463608,39.967152;116.462814,39.966431;116.462753,39.966377;116.461693,39.965412;116.460800,39.964592;116.460396,39.964237;116.460396,39.964233;116.460121,39.963974;116.459991,39.963860;116.459412,39.963337;116.458458,39.962479;116.458084,39.962132;116.457916,39.961983;116.457359,39.961472;116.457306,39.961422;116.456886,39.961063;116.456650,39.960876;116.456039,39.960464;116.455711,39.960289;116.455536,39.960209;116.454758,39.959835;116.454430,39.959644;116.454178,39.959438;116.452232,39.957672;116.452011,39.957626;116.451942,39.957619;116.451820,39.957630;116.451752,39.957661;116.451714,39.957699;116.451683,39.957748;116.451683,39.957787;116.451683,39.957817;116.451698,39.957859;116.451996,39.958145;116.452545,39.958633;116.452637,39.958664;116.452705,39.958668;116.452988,39.958641;116.453476,39.958328;116.454079,39.957935;116.454910,39.957390;116.455292,39.957123;116.455574,39.956852;116.455711,39.956722;116.455956,39.956532;116.456146,39.956383;116.456627,39.956043;116.457222,39.955643;116.457916,39.955193;116.458107,39.955059;116.458160,39.955017;116.458717,39.954659;116.459427,39.954201;116.459229,39.954124;116.459129,39.954067;116.459045,39.954010;116.458923,39.953888;116.458504,39.953533;116.458076,39.953144;116.457893,39.952972;116.457634,39.952744;116.457436,39.952560;116.457275,39.952423;116.456879,39.952053;116.456177,39.951424;116.455605,39.950909;116.455521,39.950829;116.455482,39.950760;116.455444,39.950680;116.455429,39.950474;116.455429,39.950325;116.455429,39.950096;116.455437,39.949604;116.455437,39.949440;116.455437,39.949436;116.455444,39.949112;116.455452,39.948429;116.454216,39.948242;116.453941,39.948204;116.452232,39.947952;116.451874,39.947895;116.451302,39.947800;116.450310,39.947651;116.450188,39.947552;116.450264,39.947430;116.450294,39.947323;116.450348,39.947128;116.450363,39.946930;116.450378,39.946678;116.450378,39.946453;116.450378,39.945892;116.450363,39.945690;116.450363,39.944378;116.450363,39.944096;116.450363,39.944092;116.450363,39.942520;116.450348,39.941284;116.450348,39.941185;116.450363,39.940342;116.450363,39.940159;116.450363,39.940155;116.450378,39.939892;116.450394,39.939823;116.450417,39.939243;116.450401,39.938435;116.450409,39.937840;116.450409,39.937050;116.450394,39.936646;116.450394,39.936588;116.450378,39.936207;116.450378,39.935547;116.450363,39.934643;116.450317,39.933769;116.450310,39.933613;116.450310,39.933025;116.450294,39.932671;116.450294,39.931282;116.450294,39.930984;116.450294,39.930698;116.450294,39.929718;116.450294,39.927937;116.450294,39.927547;116.450294,39.927544;116.450287,39.926975;116.450287,39.924904;116.450287,39.924351;116.450287,39.924202;116.450287,39.923122;116.450287,39.922943;116.450279,39.922825;116.450279,39.921940;116.450279,39.920994;116.450294,39.920437;116.450294,39.918690;116.450294,39.918415;116.450294,39.918411;116.450294,39.917961;116.450287,39.917740;116.450287,39.916817;116.450287,39.916740;116.450287,39.916435;116.450287,39.916050;116.450287,39.915661;116.450279,39.915215;116.450287,39.914852;116.450279,39.914471;116.450279,39.914150;116.450279,39.913399;116.450272,39.912483;116.450264,39.912354;116.450264,39.911530;116.450264,39.911026;116.450264,39.910484;116.450264,39.910309;116.450264,39.910294;116.450264,39.909588;116.450119,39.909588;116.450104,39.909401;116.450119,39.908886;116.450241,39.908669;116.450241,39.908539;116.449585,39.908546;116.447639,39.908546;116.447571,39.908546;116.446960,39.908554;116.445969,39.908550;116.444725,39.908562;116.444534,39.908569;116.443886,39.908581;116.443802,39.908581;116.442879,39.908581;116.441017,39.908588;116.440971,39.908588;116.439529,39.908604;116.438576,39.908611;116.436699,39.908607;116.436073,39.908611;116.435730,39.908619;116.435402,39.908630;116.435341,39.908665;116.435310,39.908695;116.435272,39.908714;116.435219,39.908768;116.435173,39.908825;116.435158,39.908924;116.435158,39.909172;116.435143,39.909443;116.435143,39.909710;116.435150,39.909798;116.435165,39.909870;116.435211,39.909935;116.435280,39.909966;116.435349,39.909977;116.435432,39.909969;116.435532,39.909916;116.435646,39.909752;116.435730,39.907696;116.435745,39.907406;116.435799,39.906498;116.435837,39.906208;116.435837,39.906105;116.435844,39.905937;116.435867,39.905743;116.435867,39.905689;116.435905,39.905548;116.435867,39.905437;116.435844,39.905376;116.435799,39.905327;116.435745,39.905285;116.435692,39.905251;116.435608,39.905220;116.435486,39.905197;116.435394,39.905182;116.434982,39.905178", "start_time": "0505", "end_time": "2305", "via_num": "17", "via_stops": [ { "name": "京顺路丽都饭店", "id": "110100013750006", "location": "116.476250,39.978569" }, { "name": "四元桥东", "id": "110100013750007", "location": "116.473488,39.976070" }, { "name": "四元桥西", "id": "110100013750008", "location": "116.463608,39.967155" }, { "name": "三元桥东站", "id": "110100013750009", "location": "116.460396,39.964237" }, { "name": "三元桥", "id": "110100013750010", "location": "116.457916,39.955193" }, { "name": "三元东桥西", "id": "110100013750011", "location": "116.458076,39.953144" }, { "name": "华都饭店", "id": "110100013750024", "location": "116.455437,39.949440" }, { "name": "新源南路西口", "id": "110100013750025", "location": "116.451874,39.947895" }, { "name": "塔园村", "id": "110100013750026", "location": "116.450363,39.944096" }, { "name": "幸福三村", "id": "110100013750015", "location": "116.450363,39.940159" }, { "name": "工人体育场", "id": "110100013750016", "location": "116.450310,39.933025" }, { "name": "朝阳医院", "id": "110100013750017", "location": "116.450294,39.927547" }, { "name": "东大桥路口北", "id": "110100013750018", "location": "116.450287,39.924351" }, { "name": "芳草地", "id": "110100013750023", "location": "116.450294,39.918415" }, { "name": "芳草地南", "id": "110100013750019", "location": "116.450279,39.914150" }, { "name": "永安里路口北", "id": "110100013750020", "location": "116.450264,39.910309" }, { "name": "日坛路", "id": "110100013750021", "location": "116.444725,39.908562" } ] } ] }, "entrance": [], "exit": [], "railway": { "spaces": [] } }, { "taxi": [], "walking": { "origin": "116.434975,39.905178", "destination": "116.434448,39.908073", "distance": "429", "duration": "367", "steps": [ { "instruction": "沿北京站东街步行62米左转", "road": "北京站东街", "distance": "62", "duration": [], "polyline": "116.434975,39.905178;116.435478,39.905197;116.435608,39.905220;116.435699,39.905254", "action": "左转", "assistant_action": [] }, { "instruction": "沿建国门南大街步行319米左转", "road": "建国门南大街", "distance": "319", "duration": [], "polyline": "116.435699,39.905254;116.435623,39.905735;116.435539,39.906200;116.435463,39.906509;116.435364,39.906723;116.435211,39.906971;116.435112,39.907215;116.435051,39.907452;116.435036,39.907829;116.435013,39.908073", "action": "左转", "assistant_action": [] }, { "instruction": "步行48米", "road": [], "distance": "48", "duration": [], "polyline": "116.435005,39.908073;116.434448,39.908073", "action": [], "assistant_action": [] } ] }, "bus": { "buslines": [] }, "entrance": [], "exit": [], "railway": { "spaces": [] } } ] } ] } } }

步行路径规划


接口地址:http://route.showapi.com/1997-3 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
destination String
102.709765,25.007722
目的地。规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
origin String
102.711095,25.005924
出发点。 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1997-3","my_appId","my_appSecret") .addTextPara("destination","102.709765,25.007722") .addTextPara("origin","102.711095,25.005924") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
status String
1
返回状态 值为0或1 1:成功;0:失败
info String
ok
返回的状态信息 status为0时,info返回错误原;否则返回“OK”。详情参阅info状态表
infocode String
10000
详情参阅info状态表
count String
1
返回结果总数目
route Object
路线信息列表
origin String
116.481028,39.989643
起点坐标
destination String
116.434446,39.90816
终点坐标
paths Object[]
步行方案
0 Object
distance String
11282
起点和终点的步行距离 单位:米
duration String
9026
步行时间预计 单位:秒
steps Object[]
返回步行结果列表
0 Object
instruction String
向西南步行13米左转
路段步行指示
orientation String
西南
方向
road String[]
[]
道路名称
distance String
13
此路段距离 单位:米
duration String
10
此路段预计步行时间
polyline String
116.481003,39.989311;116.480957,39.989269;116.480957,39.989269;116.480904,39.98922
此路段坐标点
action String
左转
步行主要动作
assistant_action String[]
[]
步行辅助动作
walk_type String
0
这段路是否存在特殊的方式 0,普通道路 1,人行横道 3,地下通道 4,过街天桥 5,地铁通道 6,公园 7,广场 8,扶梯 9,直梯 10,索道 11,空中通道 12,建筑物穿越通道 13,行人通道 14,游船路线 15,观光车路线 16,滑道 18,扩路 19,道路附属连接线 20,阶梯 21,斜坡 22,桥 23,隧道 30,轮渡
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "0be6aeb5487544a6aada69de877bc650", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "info": "ok", "infocode": "10000", "count": "1", "route": { "origin": "102.711095,25.005924", "destination": "102.709765,25.007722", "paths": [ { "distance": "427", "duration": "342", "steps": [ { "instruction": "步行104米到达目的地", "orientation": [], "road": [], "distance": "104", "duration": "83", "polyline": "102.709388,25.00671;102.709227,25.007639", "action": [], "assistant_action": "到达目的地", "walk_type": "0" } ] } ] } } }

驾车路径规划


接口地址:http://route.showapi.com/1997-2 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
avoidroad String
避让道路名 只支持一条避让道路
destination String
116.481028,39.989643
目的地 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。
destinationid String
目的地poiid 当终点为POI时,建议填充此值。
destinationtype String
终点的poi类别 当用户知道终点POI的类别时候,建议填充此值
number String
填入除省份及标点之外,车牌的字母和数字(需大写)。用于判断限行相关。 例如:NH1N11
origin String
116.434446,39.90816
出发点 经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位。 由于在实际使用过程中,存在定位飘点的情况。 为了解决此类问题,允许传入多个起点用于计算车头角度。规划路径时以最后一个坐标对进行规划。 格式为x1,y1|x2,y2|x3,y3。 最多允许传入3个坐标对,每对坐标之间距离必须超过2m。 虽然对每对坐标之间长度没有上限,但是如果超过4米会有概率性出现不准确的情况。
originid String
出发点poiid 当起点为POI时,建议填充此值。
origintype String
起点的poi类别 当用户知道起点POI的类别时候,建议填充此值
province String
用汉字填入车牌省份缩写,用于判断是否限行 例如:京
strategy Number 0
驾车选择策略 下方策略 0~9的策略,仅会返回一条路径规划结果。 下方10~20的策略,会返回多条路径规划结果。(高德地图APP策略也包含在内) 下方策略仅返回一条路径规划结果 0,不考虑当时路况,返回耗时最短的路线,但是此路线不一定距离最短 1,不走收费路段,且耗时最少的路线 2,距离最短的路线,但是不会考虑路况 3,不走快速路,例如京通快速路 4,躲避拥堵的路线,但是可能会存在绕路的情况,耗时可能较长 5,多策略(同时使用速度优先、费用优先、距离优先三个策略计算路径)。 其中必须说明,就算使用三个策略算路,会根据路况不固定的返回一~三条路径规划信息。 6,不走高速,但是不排除走其余收费路段 7,不走高速且避免所有收费路段 8,躲避收费和拥堵,可能存在走高速的情况,并且考虑路况不走拥堵路线,但有可能存在绕路和时间较长 9,不走高速且躲避收费和拥堵 下方策略返回多条路径规划结果 10,返回结果会躲避拥堵,路程较短,尽量缩短时间 11,返回结果时间最短,距离最短 (由于有更优秀的算法,建议不使用此值) 12,返回的结果考虑路况,尽量躲避拥堵而规划路径,与高德地图的“躲避拥堵”策略一致 13,返回的结果不走高速,与高德地图“不走高速”策略一致 14,返回的结果尽可能规划收费较低甚至免费的路径,与高德地图“避免收费”策略一致 15,返回的结果考虑路况,尽量躲避拥堵而规划路径,并且不走高速,与高德地图的“躲避拥堵&不走高速”策略一致 16,返回的结果尽量不走高速,并且尽量规划收费较低甚至免费的路径结果,与高德地图的“避免收费&不走高速”策略一致 17,返回路径规划结果会尽量的躲避拥堵,并且规划收费较低甚至免费的路径结果,与高德地图的“躲避拥堵&避免收费”策略一致 18,返回的结果尽量躲避拥堵,规划收费较低甚至免费的路径结果,并且尽量不走高速路,与高德地图的“避免拥堵&避免收费&不走高速”策略一致 19,返回的结果会优先选择高速路,与高德地图的“高速优先”策略一致 20,返回的结果会优先考虑高速路,并且会考虑路况躲避拥堵,与高德地图的“躲避拥堵&高速优先”策略一致
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1997-2","my_appId","my_appSecret") .addTextPara("avoidroad","") .addTextPara("destination","116.481028,39.989643") .addTextPara("destinationid","") .addTextPara("destinationtype","") .addTextPara("number","") .addTextPara("origin","116.434446,39.90816") .addTextPara("originid","") .addTextPara("origintype","") .addTextPara("province","") .addTextPara("strategy","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
status String
1
结果状态值,值为0或1 0:请求失败;1:请求成功
info String
OK
返回状态说明 status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表
infocode String
10000
详情参阅info状态表
count String
1
驾车路径规划方案数目
route Object
驾车路径规划信息列表
origin String
116.434446,39.90816
起点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
destination String
116.481028,39.989643
终点坐标 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位
taxi_cost String
33
打车费用 单位:元
paths Object[]
驾车换乘方案
0 Object
distance String
11948
行驶距离 单位:米
duration String
1765
预计行驶时间 单位:秒
strategy String
速度最快
导航策略
tolls String
0
此导航方案道路收费 单位:元
toll_distance String
0
收费路段距离
steps Object[]
导航路段
0 Object
导航路段
instruction String
沿建国门内大街向东行驶193米左转
行驶指示
orientation String
方向
road String
建国门内大街
道路名称
distance String
193
此路段距离 单位:米
tolls String
0
此段收费 单位:元
toll_distance String
0
收费路段距离 单位:米
toll_road String[]
[]
主要收费道路
duration String
109
持续的时间
polyline String
116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302;116.43499,39.908279;116.43528,39.908268;116.435745,39.90826;116.436264,39.90826;116.436508,39.90826;116.436661,39.908287
此路段坐标点串 格式为坐标串,如:116.481247,39.990704;116.481270,39.990726
action String
左转
导航主要动作 详见驾车动作列表
assistant_action String[]
[]
导航辅助动作 详见驾车动作列表
tmcs Object[]
驾车导航详细信息 其中包含tmc对象
0 Object
lcode String[]
[]
distance String
40
此段路的长度 单位:米
status String
畅通
此段路的交通情况 未知、畅通、缓行、拥堵、严重拥堵
polyline String
116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302
此段路的轨迹 规格:x1,y1;x2,y2
cities Object[]
0 Object
name String
北京城区
citycode String
010
参见 adcode参数表
adcode String
110100
参见 adcode参数表
districts Object[]
区域
0 Object
name String
东城区
adcode String
110101
参见 adcode参数表
restriction String
0
限行结果 0 代表限行已规避或未限行,即该路线没有限行路段 1 代表限行无法规避,即该线路有限行路段
traffic_lights String
7
红绿灯个数
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "7f071715bac74df19e4c908f865cc3de", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "info": "OK", "infocode": "10000", "count": "1", "route": { "origin": "116.434446,39.90816", "destination": "116.481028,39.989643", "taxi_cost": "33", "paths": [ { "distance": "11948", "duration": "1765", "strategy": "速度最快", "tolls": "0", "toll_distance": "0", "steps": [ { "instruction": "沿建国门内大街向东行驶193米左转", "orientation": "东", "road": "建国门内大街", "distance": "193", "tolls": "0", "toll_distance": "0", "toll_road": [], "duration": "109", "polyline": "116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302;116.43499,39.908279;116.43528,39.908268;116.435745,39.90826;116.436264,39.90826;116.436508,39.90826;116.436661,39.908287", "action": "左转", "assistant_action": [], "tmcs": [ { "lcode": [], "distance": "40", "status": "畅通", "polyline": "116.434433,39.908394;116.434586,39.908401;116.434708,39.908375;116.434883,39.908302" } ], "cities": [ { "name": "北京城区", "citycode": "010", "adcode": "110100", "districts": [ { "name": "东城区", "adcode": "110101" } ] } ] } ], "restriction": "0", "traffic_lights": "7" } ] } } }

距离测量API


接口地址:http://route.showapi.com/1997-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
destination String
116.481028,39.989643
目的地 规则: lon,lat(经度,纬度), “,”分割 如117.500244, 40.417801 经纬度小数点不超过6位
origins String
116.434446,39.90816
出发点 支持100个坐标对,坐标对见用“| ”分隔;经度和纬度用","分隔
type String
路径计算的方式和方法 0:直线距离 1:驾车导航距离(仅支持国内坐标)。 必须指出,当为1时会考虑路况,故在不同时间请求返回结果可能不同。 此策略和driving接口的 strategy=4策略一致 2:公交规划距离(仅支持同城坐标) 3:步行规划距离(仅支持5km之间的距离)
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1997-1","my_appId","my_appSecret") .addTextPara("destination","116.481028,39.989643") .addTextPara("origins","116.434446,39.90816") .addTextPara("type","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-7, API创建者的网关资源不足
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
-1014,token权限无效
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
status String
1
返回结果状态值,值为0或1,0表示请求失败;1表示请求成功
info String
OK
返回状态说明,status为0时,info返回错误原因;否则返回“OK”。详情参阅info状态表
infocode String
10000
详情参阅info状态表
results Object[]
距离信息列表
0 Object
距离信息
origin_id String
1
起点坐标,起点坐标序列号(从1开始)
dest_id String
1
终点坐标,终点坐标序列号(从1开始)
distance String
11934
路径距离,单位:米
duration String
1380
预计行驶时间,单位:秒
info String
仅在出错的时候显示该字段。大部分显示“未知错误” 由于此接口支持批量请求,建议不论批量与否用此字段判断请求是否成功
code String
仅在出错的时候显示此字段。 在驾车模式下: 1,指定地点之间没有可以行车的道路 2,起点/终点 距离所有道路均距离过远(例如在海洋/矿业) 3,起点/终点不在中国境内
...
返回示例:{ "showapi_res_error": "", "showapi_res_id": "396ad20f6adf43e79ff8087cca20641f", "showapi_res_code": 0, "showapi_res_body": { "status": "1", "info": "OK", "infocode": "10000", "results": [ { "origin_id": "1", "dest_id": "1", "distance": "11934", "duration": "1800" } ] } }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种API操纵资源。

截至2017年12月,平台已经拥有API接口230个,日调用量2000万,覆盖全网10万+真实消费者,为超过3000+的企业用户提供全域数据服务。

 

联系方式:

电话: 4009988033

 

微博: http://www.weibo.com/showapi

 

邮箱: services@showapi.com

 

QQ: 3007663665

 

微信: show_api

进制数据介绍:

企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源,同时进制数据提供数据交易等服务。通过进制数据,不仅开发成本极大降低,而且可以获得其他丰富的数据服务:数据交易,数据分析,区块链Token管理等服务。

 

 

联系我们:

电话:173-6457-5198

QQ① 群:792473404

客服 QQ:1643296538

微信客服:binstds

                                      扫描二维码添加客服微信

 

 

工作时间

 周一至周五 9:00 - 21:00(其中周三为 9:00 - 18:00) 

周六 9:00 - 12:00(节假日除外) 

 

 

进制数据团队

 

 

2020.01.01

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐