接口简介:
根据起点,终点,途经点坐标规划导航线路,支持驾车,步行导航。支持导航策略。
请求地址:
https://cn.apihz.cn/api/jiaotong/daohang.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】
【途经点坐标】【mid】【否】【设置途经点经纬度,经度与纬度用逗号隔开,多个途经点用分号隔开。例:mid=116.36506,39.91277;116.37506,39.92077】
【线路策略】【linetype】【否】【线路策略,0=用时最少,1=路线最短,2=避开高速,3=步行。默认0用时最少。例:linetype=1】
【简化数据】【type】【否】【0=返回简略数据。1=返回详细数据,详细数据收费10盟点一次,增加了更详细的路线步进坐标等各类信息,较为复杂,适用于导航。例:type=0】
返回参数:
【名称】【参数】【说明】
【状态码】【code】【200成功,400错误】
【消息内容】【msg】【信息提示。】
【路线简略数据集】【route_summary】【路线简略数据集。】
【起点坐标】【route_summary.origin】【起点坐标。】
【终点坐标】【route_summary.destination】【终点坐标。】
【途经点坐标】【route_summary.waypoints】【途经点坐标。】
【路线总距离】【route_summary.total_distance_km】【路线总距离,单位:公里。】
【路线总耗时】【route_summary.total_duration_sec】【路线总耗时,单位:秒。】
【详细导航数据集】【detailed_steps】【详细导航数据集。】
【步骤序号】【detailed_steps.step_id】【步骤序号,从0开始。】
【导航指令】【detailed_steps.instruction】【导航指令,如:沿江苏路走400米左转。】
【道路指示牌】【detailed_steps.road_sign】【道路指示牌。】
【当前道路名】【detailed_steps.current_road】【当前道路名。】
【下一道路名】【detailed_steps.next_road】【下一道路名。】
【是否收费】【detailed_steps.toll_status】【0=免费路段,1=收费路段,2=部分收费路段。】
【转向点坐标】【detailed_steps.turn_point】【用于地图标记转向位置。】
【简化导航数据集】【simplified_steps】【简化导航数据集,适合预览。】
【步骤序号】【simplified_steps.step_id】【步骤序号,从0开始。】
【导航指令】【simplified_steps.instruction】【导航指令。】
【本段涉及的道路】【simplified_steps.roads】【本段涉及的道路列表。】
【本段最后一条道路】【simplified_steps.last_road】【本段最后一条道路名。】
【连接下一段的道路名】【simplified_steps.connecting_road】【连接下一段的道路名。】
【道路指示牌】【simplified_steps.road_sign】【道路指示牌。】
【是否收费】【simplified_steps.toll_status】【0=免费路段,1=收费路段,2=部分收费路段。】
【转向点坐标】【simplified_steps.turn_point】【转向点坐标。】
【分段距离】【simplified_steps.distance_meters】【分段距离,单位:米。】
【对应详细导航数据集】【simplified_steps.segment_range】【对应详细导航数据集的索引区间。】
GET请求示例:
https://cn.apihz.cn/api/jiaotong/daohang.php?id=88888888&key=88888888&starlon=121.4279&starlat=31.20872&endlon=121.313079&endlat=31.195667&linetype=0&type=0
注意:示例里的ID与KEY为公共ID与KEY,共享每分钟调用频次限制,接口本身免费,请使用自己的ID与KEY,独享每分钟调用频次。每日调用无上限。
POST请求示例:
请根据开发语言自行POST。
返回数据示例:
示例:{"code":400,"msg":"查询失败,请重试。"}
示例:
{
"route_summary": {
"origin": "121.42790,31.20872",
"destination": "121.31308,31.19567",
"waypoints": [],
"total_distance_km": 16.25,
"total_duration_sec": 1167
},
"detailed_steps": [{
"step_id": 0,
"instruction": "从国道204/华山路向南出发,沿国道204/华山路走0.5公里并调头",
"road_sign": "",
"current_road": "国道204/华山路",
"next_road": "国道204/华山路",
"toll_status": 0,
"turn_point": [
121.42864,
31.20855]
}, {
"step_id": 1,
"instruction": "沿国道204/华山路走1.1公里并向北直行到江苏路/国道204",
"road_sign": "",
"current_road": "国道204/华山路",
"next_road": "江苏路/国道204",
"toll_status": 0,
"turn_point": [
121.43053,
31.20414]
}, {
"step_id": 2,
"instruction": "沿江苏路/国道204走400米并左转到延安西路",
"road_sign": "",
"current_road": "江苏路/国道204",
"next_road": "延安西路",
"toll_status": 0,
"turn_point": [
121.42973,
31.2129]
}, {
"step_id": 3,
"instruction": "沿延安西路走0.6公里并向延安高架路/虹桥枢纽/娄山关路方向进入延安高架路",
"road_sign": "延安高架路/虹桥枢纽/娄山关路",
"current_road": "延安西路",
"next_road": "延安高架路",
"toll_status": 0,
"turn_point": [
121.42852,
31.21592]
}, {
"step_id": 4,
"instruction": "沿延安高架路走7公里并从湖州/虹桥枢纽(南)/国道50/国家会展中心/虹桥商务区方向匝道进入沪渝高速公路/国道50/外环沪青平立交桥",
"road_sign": "湖州/虹桥枢纽(南)/国道50/国家会展中心/虹桥商务区方向匝道",
"current_road": "延安高架路",
"next_road": "沪渝高速公路/国道50/外环沪青平立交桥",
"toll_status": 0,
"turn_point": [
121.42435,
31.21262]
}, {
"step_id": 5,
"instruction": "沿沪渝高速公路/国道50/外环沪青平立交桥盘桥向西南走2.6公里并进入虹桥枢纽(南)/2号航站楼/虹桥站/出租车蓄车场方向匝道",
"road_sign": "虹桥枢纽(南)/2号航站楼/虹桥站/出租车蓄车场方向匝道",
"current_road": "沪渝高速公路/国道50/外环沪青平立交桥",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.35822,
31.18696]
}, {
"step_id": 6,
"instruction": "走300米并向西北直行到虹渝高架路",
"road_sign": "",
"current_road": "",
"next_road": "虹渝高架路",
"toll_status": 0,
"turn_point": [
121.33763,
31.17193]
}, {
"step_id": 7,
"instruction": "沿虹渝高架路走2.1公里并从火车站到达/停车库/虹桥商务区/虹桥商务区管委会/申虹公司/虹桥站到达/崧泽高架路/国道15/沈海高速/北翟高架路/中环路出口驶离",
"road_sign": "火车站到达/停车库/虹桥商务区/虹桥商务区管委会/申虹公司/虹桥站到达/崧泽高架路/国道15/沈海高速/北翟高架路/中环路出口",
"current_road": "虹渝高架路",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.33463,
31.17174]
}, {
"step_id": 8,
"instruction": "走1.3公里并从火车站到达/10号停车场出口驶离",
"road_sign": "火车站到达/10号停车场出口",
"current_road": "",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.32307,
31.18781]
}, {
"step_id": 9,
"instruction": "走100米并向北直行",
"road_sign": "",
"current_road": "",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.31401,
31.19293]
}, {
"step_id": 10,
"instruction": "走100米并左转",
"road_sign": "",
"current_road": "",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.31388,
31.19422]
}, {
"step_id": 11,
"instruction": "走70米到达目的地。",
"road_sign": "",
"current_road": "",
"next_road": "",
"toll_status": 0,
"turn_point": [
121.31382,
31.19525]
}],
"simplified_steps": [{
"step_id": 0,
"instruction": "从国道204/华山路出发,进入江苏路/国道204。",
"roads": [
"国道204/华山路"],
"last_road": "国道204/华山路",
"connecting_road": "江苏路/国道204",
"road_sign": "",
"toll_status": "free",
"turn_point": [
121.42864,
31.20855],
"distance_meters": 526,
"segment_range": "0"
}, {
"step_id": 1,
"instruction": "沿江苏路/国道204,国道204/华山路,行驶到延安西路,向延安高架路/虹桥枢纽/娄山关路方向,进入延安高架路。",
"roads": [
"江苏路/国道204",
"国道204/华山路",
""],
"last_road": "延安西路",
"connecting_road": "延安高架路",
"road_sign": "延安高架路/虹桥枢纽/娄山关路",
"toll_status": "free",
"turn_point": [
121.42852,
31.21592],
"distance_meters": 2036,
"segment_range": "1-3"
}, {
"step_id": 2,
"instruction": "沿延安高架路,行驶到虹渝高架路,在火车站到达/停车库/虹桥商务区/虹桥商务区管委会/申虹公司/虹桥站到达/崧泽高架路/国道15/沈海高速/北翟高架路/中环路出口驶离,到达到目的地。",
"roads": [
"延安高架路",
""],
"last_road": "虹渝高架路",
"connecting_road": "",
"road_sign": "火车站到达/停车库/虹桥商务区/虹桥商务区管委会/申虹公司/虹桥站到达/崧泽高架路/国道15/沈海高速/北翟高架路/中环路出口",
"toll_status": "free",
"turn_point": [
121.33463,
31.17174],
"distance_meters": 12017,
"segment_range": "4-7"
}],
"code": 200
}
参考资料(版权):
https://www.apihz.cn/api/jiaotongdaohang.html