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

qimen.alitrip.btripcar.taxi.driver.select.route.confirm (确认线上选路选择司机路线)

商旅用车在线选路确认选择的司机路线

公共参数

请求地址：

环境	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	必须	123456754		供应商订单号
route_id	String	必须	1231231232		路线id

响应参数

名称	类型	示例值	描述
errno	Number	0	错误码
errmsg	String	SUCCESS	错误信息
errcode	String	SUCCESS	二级错误码
data	SelectRouteConfirmResult		选路确认结果
route SelectRouteInfo 123456754 路线 steps LineStepInfo [] 路线步骤（按路段分） links LinkInfo [] 路线 └ 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道路长度单位米 └ road_name String XX大道该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 100 距离单位米 └ cost_time Number 1000 耗时单位秒 └ route_desc String 时间最快路线描述 └ route_id String 12345412 路线id driver_eta_info DriverEtaInfo 司机ETA信息 └ direction String 40 司机方向，正北为0度，顺时针方向 └ speed String 20 车速，正数表示向前，负数表示向后，单位是 m/s └ lng String 30.123 经度 └ lat String 120.123 维度 └ timestamp Number 1721112299 时间戳 └ remain_light_count Number 3 剩余红绿灯数 └ remain_time Number 100 剩余时间(秒) └ remain_distance Number 1000 剩余里程(米) └ order_id String 123456754 供应商订单号

请求示例

{"route_id":"1231231232","order_id":"123456754"}

响应示例

{
    "errno":0,
    "errmsg":"SUCCESS",
    "errcode":"SUCCESS",
    "data":{
        "route":{
            "steps":[
                {
                        "links":[
                            {
                                    "coords":"120.111,30.111;120.222,30.222",
                                    "traffic_status":0,
                                    "link_type":0,
                                    "time":10,
                                    "length":100,
                                    "road_name":"XX大道",
                                    "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":100,
            "cost_time":1000,
            "route_desc":"时间最快",
            "route_id":"12345412"
        },
        "driver_eta_info":{
            "direction":"40",
            "speed":"20",
            "lng":"30.123",
            "lat":"120.123",
            "timestamp":1721112299,
            "remain_light_count":3,
            "remain_time":100,
            "remain_distance":1000
        },
        "order_id":"123456754"
    }
}

验签示例

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

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

商旅API

qimen.alitrip.btripcar.taxi.driver.select.route.confirm (确认线上选路选择司机路线)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ