文档中心 > API类目 > 商旅API

qimen.alitrip.btripcar.taxi.driver.select.route.get (获取线上选路司机可选择路线)

商旅用车在线选路获取司机可选择路线

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
order_id	String	必须	1231245243		供应商订单号

响应参数

名称	类型	示例值	描述
errno	Number	0	错误码
errmsg	String	SUCCESS	错误信息
errcode	String	SUCCESS	二级错误码
data	SelectRouteGetResult		选择路线查询结果
select_routes SelectRouteInfo [] 可选择路线 steps LineStepInfo [] 路线步骤（按路段分） links LinkInfo [] 路线 └ road_name String XX大道该Link道路名称 └ coords String 120.111,30.111;120.222,30.222 该Link道路坐标点集 └ traffic_status Number 0 路况状态：0-未知状态，1-通畅，2-缓行，3-阻塞，4-严重阻塞 └ link_type Number 0 道路类型 0-普通道路 1-航道 2-隧道 3-桥梁 4-高架桥 └ time Number 10 该Link道路耗时 └ length Number 100 该Link道路长度 └ traffic String 1-0;155-1;162-0 路况(对标高德格式) └ time Number 10 该路段耗时 └ length Number 100 该路段长度 └ end_location String 120.222,30.222 结束经纬度 └ start_location String 120.111,30.111 开始经纬度 └ estimated_price String 50 预估价单位元全程价格 └ tolls String 5 路桥费单位元 └ light Number 3 红绿灯个数 └ distance Number 1000 距离单位米 └ cost_time Number 100 耗时单位秒 └ route_id String 13245632 路线id └ is_current_route Number 1 当前行驶路线(0:否 1:是) └ route_desc String 时间最短路线描述 └ select_route_num Number 3 可选择路线条数 └ order_id String 1231245243 订单号

请求示例

{"order_id":"1231245243"}

响应示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "errcode":"SUCCESS",
    "data":{
        "select_routes":[
            {
                    "steps":[
                        {
                                "links":[
                                    {
                                            "road_name":"XX大道",
                                            "coords":"120.111,30.111;120.222,30.222",
                                            "traffic_status":0,
                                            "link_type":0,
                                            "time":10,
                                            "length":100,
                                            "traffic":"1-0;155-1;162-0"
                                    }
                                ],
                                "time":10,
                                "length":100,
                                "end_location":"120.222,30.222",
                                "start_location":"120.111,30.111"
                        }
                    ],
                    "estimated_price":"50",
                    "tolls":"5",
                    "light":3,
                    "distance":1000,
                    "cost_time":100,
                    "route_id":"13245632",
                    "is_current_route":1,
                    "route_desc":"时间最短"
            }
        ],
        "select_route_num":3,
        "order_id":"1231245243"
    }
}

验签示例

{"errcode":"sign-check-failure","errno":"不等于0","errmsg":"Illegal request"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

商旅API

qimen.alitrip.btripcar.taxi.driver.select.route.get (获取线上选路司机可选择路线)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ