接口地址: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_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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 city String 昆明 是 城市/跨城规划时的起点城市 目前支持市内公交换乘/跨城公交的起点城市。 可选值:城市名称/citycode cityd String 否 跨城公交规划时的终点城市 跨城公交规划必填参数。 可选值:城市名称/citycode date String 否 出发日期 根据出发时间和日期筛选可乘坐的公交路线,格式:date=2014-3-19 destination String 102.7221,25.0149 是 目的地 规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位 origin String 102.8622,24.8658 是 出发点。规则: lon,lat(经度,纬度), “,”分割,如117.500244, 40.417801 经纬度小数点不超过6位 strategy String 否 公交换乘策略 可选值: 0:最快捷模式 1:最经济模式 2:最少换乘模式 3:最少步行模式 5:不乘地铁模式 time String 否 出发时间 根据出发时间和日期筛选可乘坐的公交路线,格式: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_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 3 公交换乘方案数目 route Object 公交换乘信息列表 - origin String 116.481028,39.989643 起点坐标 - destination String 116.434446,39.90816 终点坐标 - distance String 14248 起点和终点的步行距离 单位:米 - taxi_cost String 38.8704 出租车费用 单位:元 - transits Object[] 公交换乘方案列表 - 0 Object 公交换乘方案 - cost String 3.0 此换乘方案价格 单位:元 - duration String 3562 此换乘方案预期时间 单位:秒 - nightflag String 0 是否是夜班车 0:非夜班车;1:夜班车 - walking_distance String 1281 此方案总步行距离 单位:米 - distance String 13759 每段线路步行距离 - missed String 0 - segments Object[] 换乘路段列表 - 0 Object - taxi String[] [] - walking Object 此路段步行导航信息 - origin String 116.481003,39.989311 起点坐标 - destination String 116.481987,39.983784 终点坐标 - distance String 852 每段线路步行距离 - duration String 730 步行预计时间 - steps Object[] 步行路段列表 - 0 Object - instruction String 步行13米左转 此段路的行走介绍 - road String[] [] 路的名字 - distance String 13 此段路的距离 - duration String[] [] 此段路预计消耗时间 - polyline String 116.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 String 110100013750005 站点id - location String 116.481979,39.983788 站点经纬度 - arrival_stop Object 此段下车站 格式如:中关村 - name String 北京站东 站点名字 - id String 110100013750022 站点id - location String 116.434982,39.905178 站点经纬度 - name String 403路(环行铁道--北京站东) 公交路线名称 - id String 110100013750 公交路线id - type String 普通公交线路 公交类型 - distance String 12478 公交行驶距离 - duration String 2464 公交预计行驶时间 - polyline String 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 String 0505 首班车时间 - end_time String 2305 末班车时间 - via_num String 17 此段途经公交站数 - via_stops Object[] 此段途经公交站点列表 - 0 Object - name String 京顺路丽都饭店 途径公交站点信息 - id String 110100013750006 公交站点编号 - location String 116.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 否 填入除省份及标点之外,车牌的字母和数字(需大写)。用于判断限行相关。 例如:NH1N11origin 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"
}
]
}
}
}
接口地址: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