路线规划
2020年02月05日

接口描述

请求路径:https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/directions/driving

请求方法:GET

输入参数

参数名称 必选 类型 描述
origin string 起点经纬度:lng,lat,经纬度小数点后不超过6位。
roadlevels string 起点绑路道路等级:1高速道路,2城市高速,3国道,4省道,5县道,6乡镇村道,7其它道路,8九级路,9轮渡,10行人道路,11人渡,12自行车专用道。如果输入多个等级,1|2|3|…,则只返回指定等级的道路;没有输入,则返回所有等级道路
road_funcclasses string 起点绑路道路功能等级,1|2|…
roadname string 起点绑路道路名称
destination string 终点经纬度:lng,lat,经纬度小数点后不超过6位。
waypoints string 途径点:lng,lat|lng,lat|…。最多支持30个,10个以上收费更高。
strategy string 默认值0,路线规划策略:0(综合模式)、1(时间最短)、2(距离最短)、3(不走高速)、4(少收费)、5(高速优先)、6(红绿灯少)
alternatives string 默认值false,是否返回备选路线,最多3条。有途径点的时候,此参数被忽略。
departure_time string 指定出发时间,UNIX时间戳,只能是当前时间和未来7天内的时间。
avoid_polygons string 区域避让,当前仅支持矩形区域,最多30个。区域之间“$”分隔,每个区域的经纬度之间“|”分隔
avoid_road string 避让道路名,只支持一条。
avoids string 避让:1(轮渡)、2(收费)、3(高速)。多种避让类型代码之间“|”分隔
plate_number string 限行参数,车牌号,如“京A12345”,也支持7位新能源车牌号

输出参数

参数名称 类型 描述
status int 状态码
info string 状态说明
result Result 请求返回数据

Result:

参数名称 类型 描述
routes array<Routes> 路线json数组

Routes:

参数名称 类型 描述
routeid string 路线ID
strategy string 策略
toll float 此导航方案道路收费金额,单位:元
toll_distance float 此导航方案道路收费距离长度,单位:米
restriction string 限行结果:0表示无限行;1打破避让轮渡;2打破避让收费;3打破避让高速;4打破车辆限行;5打破区域避让;6打破道路避让
traffic_lights string 此路线红绿灯个数
distance int 距离,单位米
duration int 时间,单位分
legs array<Legs> 起点到第一个途径点;途径点之间;最后一个途径点到终点

Legs:

参数名称 类型 描述
distance string 路径距离,单位:米
duration int64 预计行驶时间,单位:秒
outline string 路段坐标点串,lng,lat;lng,lat;...

错误码

错误码

示例

请求:

curl -X GET \
  'https://mapapi-routes.apigw-gz.didiyunapi.com/api/v1/directions/driving?destination=116.345052,39.947689&origin=116.424966,39.976888'

输出:

{
   "status":0,
   "info":"OK",
   "result":{
       "routes":[
            {
               "routeid":"491552626cdebc3ca13df6787817fcfd",
               "strategy":"",
               "toll":"",
               "toll_distance":"",
               "restriction":"",
               "traffic_lights":"",
               "distance":12303,
               "duration":1829,
               "legs":[
                    {
                       "distance":12303,
                       "duration":1829,
                       "outline":"116.42495,39.97705;116.42576,39.97706;"
                    }
                ]
            }
        ]
    }
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666