接口简介:
根据起点终点经纬度规划公交线路。起点与终点经纬度可通过设备定位或其他方式自行预先获取。也可通过【位置坐标-查指定地址经纬度坐标】接口查询,地址:https://www.apihz.cn/api/jwjuhe.html
请求地址:
https://cn.apihz.cn/api/jiaotong/gongjiao.php
请求方式:
POST或GET。
请求参数:
【名称】【参数】【必填】【说明】
【用户ID】【id】【是】【用户中心的数字ID,例:id=10000000】
【用户KEY】【key】【是】【用户中心通讯秘钥,例:key=15he5h15ty854j5sr152hs2】
【起点经度】【starlon】【是】【起点经度,例:starlon=121.4279】
【起点纬度】【starlat】【是】【起点纬度,例:starlat=31.20872】
【终点经度】【endlon】【是】【起点经度,例:endlon=121.313079】
【终点纬度】【endlat】【是】【终点纬度,例:endlat=31.195667】
【线路策略】【linetype】【否】【线路策略,例如时间最少,地铁优先,排除地铁,步行最少等。传参1-15,默认1=默认策略。具体请自行调试,建议保持默认。例:linetype=1】
【简化数据】【type】【否】【0=返回简略数据,包含各方案线路,分段站点,站点坐标,分段耗时等。1=返回详细数据,增加了更详细的路线步进坐标等各类信息,较为复杂,适用于导航预览。默认0,如非必要建议保持默认返回简略数据。例:type=0】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误】
【消息内容】【msg】【信息提示。】
【整体数据集】【datas】【整体数据集。】
【方案规划】【datas.lineName】【某个方案线路规划,以竖杠隔开换成线路。】
【分段数据集】【datas.segments】【某个方案下整条线路所有分段的数据集,即途径的各站点数据,即某某站到某某站的数据。】
【分段起点数据集】【datas.segments.stationStart】【某一个分段起点数据集。含站点名称,站点编号,站点坐标。注意第一站的起点坐标一般为传参的起点坐标,第一站的终点坐标一般为上车点坐标,也就是上车点车站。】
【分段终点数据集】【datas.segments.stationEnd】【某一个分段终点数据集。含站点名称,站点编号,站点坐标。】
【分段耗时】【datas.segments.segmentTimes】【即该分段路程需要的时间,单位:分钟。】
GET请求示例:
https://cn.apihz.cn/api/jiaotong/gongjiao.php?id=88888888&key=88888888&starlon=121.4279&starlat=31.20872&endlon=121.313079&endlat=31.195667&linetype=1&type=0
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"查询失败,请重试。"}
示例:
{
"code": 200,
"datas": [{
"lineName": "地铁10号线 |",
"segments": [{
"stationStart": {
"name": "",
"uuid": "",
"lonlat": "121.4279,31.2087"
},
"stationEnd": {
"name": "交通大学站6号口",
"uuid": "1429089",
"lonlat": "121.429851,31.203733"
},
"segmentTimes": 14
}, {
"stationStart": {
"name": "交通大学站",
"uuid": "1429089",
"lonlat": "121.429851,31.203733"
},
"stationEnd": {
"name": "虹桥火车站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"segmentTimes": 20
}, {
"stationStart": {
"name": "虹桥火车站地铁站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"stationEnd": {
"name": "",
"uuid": "",
"lonlat": "121.31308,31.1956"
},
"segmentTimes": 8
}]
}, {
"lineName": "113路 | 地铁10号线 |",
"segments": [{
"stationStart": {
"name": "",
"uuid": "",
"lonlat": "121.4279,31.2087"
},
"stationEnd": {
"name": "华山路湖南路",
"uuid": "1461336",
"lonlat": "121.428817,31.20775"
},
"segmentTimes": 4
}, {
"stationStart": {
"name": "华山路湖南路",
"uuid": "1461336",
"lonlat": "121.428817,31.20775"
},
"stationEnd": {
"name": "左家宅",
"uuid": "1461121",
"lonlat": "121.420079,31.199689"
},
"segmentTimes": 4
}, {
"stationStart": {
"name": "左家宅",
"uuid": "1461121",
"lonlat": "121.420079,31.199689"
},
"stationEnd": {
"name": "虹桥路站4号口",
"uuid": "1431385",
"lonlat": "121.417724,31.198495"
},
"segmentTimes": 6
}, {
"stationStart": {
"name": "虹桥路站",
"uuid": "1431385",
"lonlat": "121.417724,31.198495"
},
"stationEnd": {
"name": "虹桥火车站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"segmentTimes": 18
}, {
"stationStart": {
"name": "虹桥火车站地铁站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"stationEnd": {
"name": "",
"uuid": "",
"lonlat": "121.31308,31.1956"
},
"segmentTimes": 8
}]
}, {
"lineName": "地铁10号线 | 835路 |",
"segments": [{
"stationStart": {
"name": "",
"uuid": "",
"lonlat": "121.4279,31.2087"
},
"stationEnd": {
"name": "交通大学站6号口",
"uuid": "1429089",
"lonlat": "121.429851,31.203733"
},
"segmentTimes": 14
}, {
"stationStart": {
"name": "交通大学站",
"uuid": "1429089",
"lonlat": "121.429851,31.203733"
},
"stationEnd": {
"name": "虹桥火车站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"segmentTimes": 20
}, {
"stationStart": {
"name": "虹桥火车站地铁站",
"uuid": "1431250",
"lonlat": "121.316195,31.195677"
},
"stationEnd": {
"name": "虹桥高铁出发(南)2号口(下客站)",
"uuid": "1426184",
"lonlat": "121.315955,31.195128"
},
"segmentTimes": 2
}, {
"stationStart": {
"name": "虹桥高铁出发(南)2号口(下客站)",
"uuid": "1426184",
"lonlat": "121.315955,31.195128"
},
"stationEnd": {
"name": "虹桥西交通中心",
"uuid": "1426698",
"lonlat": "121.312596,31.194567"
},
"segmentTimes": 1
}, {
"stationStart": {
"name": "虹桥西交通中心",
"uuid": "1426698",
"lonlat": "121.312596,31.194567"
},
"stationEnd": {
"name": "",
"uuid": "",
"lonlat": "121.31308,31.1956"
},
"segmentTimes": 3
}]
}, {
"lineName": "320路 |",
"segments": [{
"stationStart": {
"name": "",
"uuid": "",
"lonlat": "121.4279,31.2087"
},
"stationEnd": {
"name": "交通大学",
"uuid": "1461129",
"lonlat": "121.431506,31.203149"
},
"segmentTimes": 16
}, {
"stationStart": {
"name": "交通大学",
"uuid": "1461129",
"lonlat": "121.431506,31.203149"
},
"stationEnd": {
"name": "虹桥西交通中心",
"uuid": "1443220",
"lonlat": "121.313996,31.194162"
},
"segmentTimes": 44
}, {
"stationStart": {
"name": "虹桥西交通中心",
"uuid": "1443220",
"lonlat": "121.313996,31.194162"
},
"stationEnd": {
"name": "",
"uuid": "",
"lonlat": "121.31308,31.1956"
},
"segmentTimes": 5
}]
}, {
"lineName": "71路中运量 | 173路 |",
"segments": [{
"stationStart": {
"name": "",
"uuid": "",
"lonlat": "121.4279,31.2087"
},
"stationEnd": {
"name": "番禺路",
"uuid": "1425659",
"lonlat": "121.424649,31.212836"
},
"segmentTimes": 13
}, {
"stationStart": {
"name": "番禺路",
"uuid": "1425659",
"lonlat": "121.424649,31.212836"
},
"stationEnd": {
"name": "吴宝路",
"uuid": "1425669",
"lonlat": "121.335365,31.174859"
},
"segmentTimes": 35
}, {
"stationStart": {
"name": "吴宝路",
"uuid": "1425669",
"lonlat": "121.335365,31.174859"
},
"stationEnd": {
"name": "沪青平公路吴宝路",
"uuid": "1450512",
"lonlat": "121.334725,31.17443"
},
"segmentTimes": 2
}, {
"stationStart": {
"name": "沪青平公路吴宝路",
"uuid": "1450512",
"lonlat": "121.334725,31.17443"
},
"stationEnd": {
"name": "虹桥西交通中心",
"uuid": "1439821",
"lonlat": "121.312605,31.194688"
},
"segmentTimes": 10
}, {
"stationStart": {
"name": "虹桥西交通中心",
"uuid": "1439821",
"lonlat": "121.312605,31.194688"
},
"stationEnd": {
"name": "",
"uuid": "",
"lonlat": "121.31308,31.1956"
},
"segmentTimes": 3
}]
}]
}
参考资料(版权):
https://www.apihz.cn/api/jiaotonggongjiao.html