名称	参数	必填	说明
开发者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
动态秘钥	dkey	否	开发者开启动态秘钥验证后需传此参数，主要针对直接在客户端调用接口的场景。请在官网后台菜单【个人资料】里配置。例：dkey=0cd2a494831736587c33f30d1e544371
用户IP	uip	否	接口调用者IP，用于后台统计IP地域分布，ISP运营商，时段IP数统计等，如不传该参数则默认为接口请求端IP，该参数主要用于使用后端服务器/中间件请求接口的方式使用。例：uip=123.123.123.123。该参数彩钻会员和炫钻会员专享。

返回参数说明

名称	参数	说明
状态码	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	对应详细导航数据集的索引区间。

返回数据示例

示例：{"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
}

更新记录

2025-12-16 18:54:06 - 修复途经点无效的BUG。

2025-08-13 13:22:44 - 新增接口。

交通运输-导航规划-2025-12-16 18:54:06

根据起点，终点，途经点坐标规划导航线路，支持驾车，步行导航。支持导航策略。

调用限制

调用权限	非定制接口直接使用
单价/次	免费[无上限]
单日[所有用户之和]	999999999
1分钟并发[所有用户之和]	999999999
1小时并发[所有用户之和]	999999999
频次限制[注册用户]	10次/分钟\|每日无上限
频次限制[钻石会员]	最高8000+次/分钟\|每日无上限
频次限制[定制频次]	联系我们定制

调用方法

请求方式	GET/POST
返回格式	JSON
编码格式	UTF-8

调用信息

浏览量	1029
今日总计调用	0
昨日总计调用	25
历史总计调用	1734
今日排名	372
总排名	291

自检信息

自检启用状态	未开启
自检节点	/
自检线路	彩钻接口线路
自检时间	/
自检耗时	/ 毫秒
自检状态	/
历史自检成功数	/ 次
历史自检失败数	/ 次
历史自检成功率	/ %
今日自检成功数	/ 次
今日自检失败数	/ 次
今日自检成功率	/ %